Java Source
Official

See:
Description

Java Source

org.netbeans.api.java.loaders
org.netbeans.api.java.source	Permits inspection and modification of the structure of Java sources.
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)?

• Jan 26 '12 Added SourceUtils.waitUserActionTask.

  Added class ScanUtils, which help to check completness of parsing data and allow to restart processing after project scan finishes to see most complete data. Elements can be checked using new methods checkElement, resolveElement, findElement and findTypeElement that throws an exception indicating the user task should be aborted and restarted later. See javadoc for more info.

• Jan 26 '12 Added TaskIndexingMode into JavaSourceTaskFactorys

  The CancellableTasks created by the JavaSourceTaskFactorys are not executed during the scan to keep the semantic backward compatibility. Constructors with the TaskIndexingMode were added into these factories to allow tasks to run during the scan.

• Nov 30 '11 Added TreePathHandle.getElementHandle.

  Added TreePathHandle.getElementHandle that returns corresponding ElementHandle for given TreePathHandle.

• Nov 7 '11 Added TreeUtilities.isCompileTimeConstantExpression.

  Added TreeUtilities.isCompileTimeConstantExpression that tests whether the given expression is a compile-time constant.

• Oct 26 '11 Added CompilationInfo.getCachedValue, CompilationInfo.putCachedValue and CompilationInfo.CacheClearPolicy.

  Added CompilationInfo.getCachedValue and CompilationInfo.putCachedValue methods and CompilationInfo.CacheClearPolicy enum so that tasks can easily store temporary data with predictable termination.

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?
JavaSourceAPI	Exported	Official	index.html

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.