Overview (Java Source)

Java Source
Package	Description
org.netbeans.api.java.loaders
org.netbeans.api.java.source
org.netbeans.api.java.source.support
org.netbeans.spi.java.loaders

Provides Java Model API access. ensure.built.source.roots When the ensure.built.source.roots property is set during ant script execution, the javac task will not actually build the classfiles from scratch, but rather copy classfiles produced by the Java infrastructure into the output folder. The content of the property will be interpreted as list of source roots, for which the artifacts should be copied.

What is New (see all changes)?

Jul 15 '14 Added a possibility to specify remote javadoc handling policy
Added a possibility to specify remote javadoc handling policy in JavadocHelper
Jul 10 '14 Added API to preserve comments and whitespaces in transformations
If a transformation moves a Tree node elsewhere, or produces a replacement of it, it can now mark the new tree as a 'replacement' for the old one, which causes whitespaces (most notably comments) to attach to the replacement node.
Apr 30 '14 Desktop independent parts of the Java Source module extracted

Runtime compatibility remains, compile time compatibility is mostly preserved too. It is however recommended to upgrade dependencies of client modules. Try running ant fix-dependencies in your Ant module.
Apr 14 '14 Added couple of new utility methods to TreeUtilities, ElementUtilities, and SourceUtils.
Added new utility methods getPathElementOfKind and getUninitializedFields to TreeUtilities. Added new utility methods getElementName, findOverridableMethods, hasGetter and hasSetter to ElementUtilities. Added new utility methods resolveCapturedType and getForwardReferences to SourceUtils.
Nov 19 '13 Added utility methods to find span of a Label's name in the source.
Added utility methods to find span of a Label's name in the source. Returns starting and ending offset of the label's name in the source code that was parsed (ie. CompilationInfo.getText()), which may differ from the positions in the source document if it has been already altered.

Use Cases

XXX no answer for arch-usecases

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 systemproperty interfaces

Interface Name	In/Out	Stability	Specified in What Document?
ensure.built.source.roots	Exported	Under Development	When the `ensure.built.source.roots` property is set during ant script execution, the `javac` task will not actually build the classfiles from scratch, but rather copy classfiles produced by the Java infrastructure into the output folder. The content of the property will be interpreted as list of source roots, for which the artifacts should be copied.

Group of java interfaces

Interface Name

In/Out

Stability

Specified in What Document?

Group of lookup interfaces

Interface Name	In/Out	Stability	Specified in What Document?
org.openide.loaders.CreateFromTemplateAttributesProvider	Exported	Official	Attributes provider is registered in `META-INF/services`. It provides `package`, `javaSourceLevel` and `java15style` attributes for java templates using scripting support.

Group of property interfaces

Interface Name	In/Out	Stability	Specified in What Document?
package	Exported	Official	`package` attribute contains java package as `String` for newly created templates using scripting.
javaSourceLevel	Exported	Official	`javaSourceLevel` attribute contains java source level as `String` (e.g. "1.5") for newly created templates using scripting.
java15style	Exported	Official	`java15style` attribute is defined for newly created templates using scripting only if java source level is 1.5 or later. Useful to conditionally generate code with java 1.5 features (generics, annotations, etc.).

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?

XXX no answer for deploy-dependencies

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

Java SourceFriend, Private or Third Party