Java SE Projects
Friend, Private or Third Party

See:
Description

Java SE Projects

org.netbeans.modules.java.j2seproject.api

Uses various project APIs to implement the project type. Build system design document

1. j2se-project.xsd

   Definition of j2seproject-specific portions of project.xml (1st revision).

2. j2se-project-2.xsd

   Definition of j2seproject-specific portions of project.xml (2nd revision).

3. project.properties

   Definition of recognized keys in project.properties and/or private.properties. XXX not yet formally specified.

4. build-impl.xml

   Definition of targets in build-impl.xml which may be called or overridden in build.xml. XXX not yet formally specified.

What is New (see all changes)?

• Aug 17 '11 Enable correct handling of properties in Project Property dialog of an extension of JSE Project

  Added interface J2SECustomPropertySaver with method save() to enable correct saving of properties added by JSE Project extending modules. If a JSE Project extending module adds/modifies panels in Project Property panels, then a mechanism is needed to ensure that all user-modified properties are correctly stored in project.properties and private.properties when OK pressed.

• Aug 17 '11 Enable extending existing JSE Project category panels in Project Properties dialog

  Replace the existing J2SERunConfigProvider interface by J2SECategoryExtensionProvider. The old interface was hardwired to enable extension of Run panel only with one extension panel only. The new interface provides this mechanism for any category and allows multiple extension panels per category. The new functionality is needed for JavaFX 2.0 support module, but is not limited to it.

• Jan 4 '07 Added class for accessing PropertyEvaluator for given JSE Project

  Added class J2SEPropertyEvaluator with method evaluator() for accessing PropertyEvaluator for given JSE Project. PropertyEvaluator resolves property values for properties defined in project.properties and private.properties.

Use Cases

Covered by UI specification and design document.

Exported Interfaces

This table lists all of the module exported APIs with defined stability classifications. It is generated based on answers to questions about the architecture of the module. Read them all...

Group of dtd interfaces

Interface Name	In/Out	Stability	Specified in What Document?
j2se-project.xsd	Exported	Official	...//www.netbeans.org/ns/j2se-project/1.xsd Definition of j2seproject-specific portions of project.xml (1st revision).
j2se-project-2.xsd	Exported	Official	...//www.netbeans.org/ns/j2se-project/2.xsd Definition of j2seproject-specific portions of project.xml (2nd revision).

Group of java.io.File interfaces

Interface Name	In/Out	Stability	Specified in What Document?
project.properties	Exported	Under Development	Definition of recognized keys in project.properties and/or private.properties. XXX not yet formally specified.
build-impl.xml	Exported	Under Development	Definition of targets in build-impl.xml which may be called or overridden in build.xml. XXX not yet formally specified.

Group of java interfaces

Interface Name	In/Out	Stability	Specified in What Document?
J2SEPropertyEvaluator	Exported	Friend	Module provides public package org.netbeans.modules.java.j2seproject.api with interface for resolving values of project properties defined in project.properties and private.properties files.

Group of org.apache.tools.ant.Task interfaces

Interface Name

In/Out

Stability

Specified in What Document?

Group of systemproperty interfaces

Interface Name	In/Out	Stability	Specified in What Document?
j2seproject.transparentUpdate	Exported	Private	If the property is set to true the project updates metadata of project.xml from the namespace http://www.netbeans.org/ns/j2se-project/1 to http://www.netbeans.org/ns/j2se-project/2 without explicit user confirmation.

Group of layer interfaces

Interface Name	In/Out	Stability	Specified in What Document?
J2SEProjectCustomizer	Exported	Official	"Projects/org-netbeans-modules-java-j2seproject/Customizer" folder's content is used to construct the project's customizer. It's content is expected to be ProjectCustomizer.CompositeCategoryProvider instances. The lookup passed to the panels contains an instance of Project and org.netbeans.modules.java.j2seproject.ui.customizer.J2SEProjectProperties Please note that the latter is not part of any public APIs and you need implementation dependency to make use of it.
J2SELogicalViewProvider	Exported	Official	"Projects/org-netbeans-modules-java-j2seproject/Nodes" folder's content is used to construct the project's child nodes. It's content is expected to be NodeFactory instances.
J2SELookup	Exported	Official	"Projects/org-netbeans-modules-java-j2seproject/Lookup" folder's content is used to construct the project's additional lookup. It's content is expected to be LookupProvider instances. J2SE project provides LookupMergers for Sources, PrivilegedTemplates and RecommendedTemplates. Implementations added by 3rd parties will be merged into a single instance in the project's lookup.

Implementation Details

Where are the sources for the module?

The sources for the module are in the NetBeans Mercurial repositories.

What do other modules need to do to declare a dependency on this one, in addition to or instead of a plain module dependency?

N/A

Read more about the implementation in the answers to architecture questions.