Java Support APIs
Official

JavaSupportAPIs The Java Support APIs provides basic facilities for getting or supplying information about Java-language source files.

See:
Description

Java Support APIs

org.netbeans.api.java.classpath
org.netbeans.api.java.queries	Java-specific queries.
org.netbeans.spi.java.queries	Implementations of Java-related queries.

JavaSupportAPIs The Java Support APIs provides basic facilities for getting or supplying information about Java-language source files. It is based on the query pattern so implementations can be supplied from other modules or projects.

What is New (see all changes)?

• Jun 7 '12 The SourceLevelQuery supports source level synonyms

  The semantics of the SourceLevelQuery, SourceLevelQueryImplementation and SourceLevelQueryImplementation2 was extended to support source level synonyms. The SourceLevelQueryImplementation and SourceLevelQueryImplementation2 can return source level synonyms, e.g. "5" for "1.5". These synonyms are always normalized by the SourceLevelQuery before they are teturned to an API client.

• May 23 '12 Introducing JavaClassPathConstants.COMPILE_ONLY

  Added a new COMPILE_ONLY classpath type allowing project types to add classpath resources which should be included in the complile classpath but should not be inherited by runtime classpath.

• Aug 11 '11 Added SourceJavadocAttacher to allow clients to attach source (javadoc) roots to binary root

  Added an API to allow clients to attach source roots and javadoc roots to binary roots. The API delegates to SPI implementations which provide specific behavior depending on type of binary root (platform, library, maven artifact). There is also fallback implementation handling unknown binary roots by storing the bindings into IDE's userdir.

• Jul 8 '10 Added notifications about source level changes into SourceLevelQuery

  The SourceLevelQuery did not allow listening on the source level changes. Such a notifications are required by the annotation processor support and indexing. This API change adds a SourceLevelQuery.getSourceLevel2 which returns a Result object which allows listening like other queries.

• Apr 15 '10 Introducing AnnotationProcessingQuery.Result.Trigger

  Modifying AnnotationProcessingQuery.Result.annotationProcessingEnabled() to return a set of triggers on which the annotation processors should be run.

Use Cases

The API is widely used by all sorts of IDE modules which need to work with Java sources. They can find Javadoc, unit tests, source level, etc. The SPI is intended mainly for Java platform and library providers, and project type providers, to declare all of this information.

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

Interface Name	In/Out	Stability	Specified in What Document?
JavaSupportAPIs	Exported	Official	The Java Support APIs provides basic facilities for getting or supplying information about Java-language source files. It is based on the query pattern so implementations can be supplied from other modules or projects.

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?

Nothing.

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