All Classes

Introduction

What do the Dates Mean?

The supplied dates indicate when the API change was made, on the CVS trunk. From this you can generally tell whether the change should be present in a given build or not; for trunk builds, simply whether it was made before or after the change; for builds on a stabilization branch, whether the branch was made before or after the given date. In some cases corresponding API changes have been made both in the trunk and in an in-progress stabilization branch, if they were needed for a bug fix; this ought to be marked in this list.

The release41 branch was made on Apr 03 '05 for use in the NetBeans 4.1 release. Specification versions: 6.0 begins after this point.
The release40 branch was made on Nov 01 '04 for use in the NetBeans 4.0 release. Specification versions: 5.0 begins after this point.

Index of APIs

Java Source API

Incompatible changes by date

Fuller descriptions of all changes can be found below (follow links).

Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.

(May 25 '14) Remove dependency on Openide Text API
(Apr 30 '14) Desktop independent parts of the Java Source module extracted

All changes by date

(Jan 10 '23) Source file name for Element
(May 12 '21) Adding SourceUtils.isClassFile(FileObject)
(Mar 23 '21) Adding TreeUtilities.isExpressionStatement(ExpressionTree)
(Mar 23 '21) Added new method for getting Tree using VariableTree type
(Mar 9 '20) Adding SourceUtils.forceSource(CompilationController, FileObject)
(Feb 8 '20) CodeStyle.parensAroundSingularLambdaParam() added
(Feb 27 '19) Creates a new SwitchExpressionTree
(Jan 22 '19) Find the target of Break or Continue statement
(Dec 7 '18) Adding Matcher.setKeepSyntheticTrees method
(Sep 6 '18) Adding case-related overload to TreeMaker
(Jul 18 '18) Check the tree has compile error in given collection of errors.
(May 14 '18) Check the tree is the end of compound declaration.
(May 3 '18) Check the tree is the end of compound declaration.
(Apr 20 '18) Check the var type variable in given tree path.
(Mar 27 '18) Check the var type variable in given tree path.
(Jan 17 '17) Added a method to create an ElementHandle for module
(Oct 4 '16) Added methods to generate/modify the module-info.java files
(Oct 4 '16) Added an information about changes in the module-info
(May 31 '16) List elements with their definining Scope
(May 16 '16) Provide type suitable for declaration in source
(May 10 '16) Allow to return also unimplemented default methods
(Oct 5 '15) Code Generator uses caret location to insert members
(Sep 23 '15) ClassIndex SearchKind extended by FUNCTIONAL_IMPLEMENTORS
(Jun 27 '15) ClassIndex returns resources from binaryroots
(Feb 9 '15) Code Generator uses dependencies between fields
(May 25 '14) Remove dependency on Openide Text API
(Apr 30 '14) Desktop independent parts of the Java Source module extracted

Changes by version

These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:

OpenIDE-Module-Module-Dependencies: $codebase > 1.20

(12.4) Added new method for getting Tree using VariableTree type
(1.2.9) ClassIndex SearchKind extended by FUNCTIONAL_IMPLEMENTORS
(1.2.60) Source file name for Element
(1.2.6) ClassIndex returns resources from binaryroots
(1.2.56) Adding TreeUtilities.isExpressionStatement(ExpressionTree)
(1.2.51) Adding SourceUtils.isClassFile(FileObject)
(1.2.46) Adding SourceUtils.forceSource(CompilationController, FileObject)
(1.2.45) CodeStyle.parensAroundSingularLambdaParam() added
(1.2.40) Adding Matcher.setKeepSyntheticTrees method
(1.2.39) Adding case-related overload to TreeMaker
(1.2.37) Check the tree has compile error in given collection of errors.
(1.2.34) Check the tree is the end of compound declaration.
(1.2.33) Check the tree is the end of compound declaration.
(1.2.32) Check the var type variable in given tree path.
(1.2.31) Check the var type variable in given tree path.
(1.2.26) Added a method to create an ElementHandle for module
(1.2.23) Added methods to generate/modify the module-info.java files
(1.2.23) Added an information about changes in the module-info
(1.2.2) Code Generator uses dependencies between fields
(1.2.17) Provide type suitable for declaration in source
(1.2.16) List elements with their definining Scope
(1.2.15) Allow to return also unimplemented default methods
(1.2.11) Code Generator uses caret location to insert members
(1.1) Remove dependency on Openide Text API
(1.0) Desktop independent parts of the Java Source module extracted
(1.2.41.0) Creates a new SwitchExpressionTree
(1.2.40.0) Find the target of Break or Continue statement

Changes by affected class

`org.netbeans.api.java.source.ClassIndex`

(Sep 23 '15) ClassIndex SearchKind extended by FUNCTIONAL_IMPLEMENTORS
(Jun 27 '15) ClassIndex returns resources from binaryroots

`org.netbeans.api.java.source.CodeStyle`

(Feb 8 '20) CodeStyle.parensAroundSingularLambdaParam() added
(Oct 5 '15) Code Generator uses caret location to insert members
(Feb 9 '15) Code Generator uses dependencies between fields

`org.netbeans.api.java.source.ElementHandle`

(Jan 17 '17) Added a method to create an ElementHandle for module

`org.netbeans.api.java.source.ElementUtilities`

(May 31 '16) List elements with their definining Scope
(May 10 '16) Allow to return also unimplemented default methods

`org.netbeans.api.java.source.matching.Matcher`

(Dec 7 '18) Adding Matcher.setKeepSyntheticTrees method

`org.netbeans.api.java.source.ModificationResult`

(May 25 '14) Remove dependency on Openide Text API

`org.netbeans.api.java.source.SourceUtils`

(Jan 10 '23) Source file name for Element
(May 12 '21) Adding SourceUtils.isClassFile(FileObject)
(Mar 9 '20) Adding SourceUtils.forceSource(CompilationController, FileObject)

`org.netbeans.api.java.source.TreeMaker`

(Mar 23 '21) Added new method for getting Tree using VariableTree type
(Feb 27 '19) Creates a new SwitchExpressionTree

`org.netbeans.api.java.source.TreeUtilities`

(Mar 23 '21) Adding TreeUtilities.isExpressionStatement(ExpressionTree)
(Jan 22 '19) Find the target of Break or Continue statement
(Sep 6 '18) Adding case-related overload to TreeMaker
(Jul 18 '18) Check the tree has compile error in given collection of errors.
(May 14 '18) Check the tree is the end of compound declaration.
(May 3 '18) Check the tree is the end of compound declaration.
(Apr 20 '18) Check the var type variable in given tree path.
(Mar 27 '18) Check the var type variable in given tree path.

`org.netbeans.api.java.source.TypesEvent`

(Oct 4 '16) Added methods to generate/modify the module-info.java files
(Oct 4 '16) Added an information about changes in the module-info

`org.netbeans.api.java.source.TypeUtilities`

(May 16 '16) Provide type suitable for declaration in source

Details of all changes by API and date

Java Source API

Source file name for Element

Jan 10 '23; API spec. version: 1.2.60; affected top-level classes: SourceUtils; made by: jtulach
It is possible to hint SourceUtils.getFile list of file names to searh for. There is also SourceUtils.findSourceFileName to obtain name of file for an Element.

Adding SourceUtils.isClassFile(FileObject)

May 12 '21; API spec. version: 1.2.51; affected top-level classes: SourceUtils; made by: dbalek
Adding SourceUtils.isClassFile(FileObject).

Adding TreeUtilities.isExpressionStatement(ExpressionTree)

Mar 23 '21; API spec. version: 1.2.56; affected top-level classes: TreeUtilities; made by: dbalek
Adding TreeUtilities.isExpressionStatement(ExpressionTree).

Added new method for getting Tree using VariableTree type

Mar 23 '21; API spec. version: 12.4; affected top-level classes: TreeMaker; made by: singh-akhilesh

Regarding the JEP 394 (finalization of pattern matching for instanceof in JDK 16). The shape of the BindingPatternTree has changed; the BindingPatternTree does not have a name and type, but rather a VariableTree.

Adding SourceUtils.forceSource(CompilationController, FileObject)

Mar 9 '20; API spec. version: 1.2.46; affected top-level classes: SourceUtils; made by: jlahoda
Adding SourceUtils.forceSource(CompilationController, FileObject).

CodeStyle.parensAroundSingularLambdaParam() added

Feb 8 '20; API spec. version: 1.2.45; affected top-level classes: CodeStyle; made by: jlahoda
Method CodeStyle.parensAroundSingularLambdaParam() has been added.

Creates a new SwitchExpressionTree

Feb 27 '19; API spec. version: 1.2.41.0; affected top-level classes: TreeMaker; made by: vikasprabhakar
Creates a new SwitchExpressionTree.

Find the target of Break or Continue statement

Jan 22 '19; API spec. version: 1.2.40.0; affected top-level classes: TreeUtilities; made by: sarveshkesharwani

Find the target of break or continue statement. Target is of type Tree here.

Adding Matcher.setKeepSyntheticTrees method

Dec 7 '18; API spec. version: 1.2.40; affected top-level classes: Matcher; made by: jlahoda
Added Matcher.setKeepSyntheticTrees method, that allows to keep synthetically generated variables mapping in the outgoing variables.

Adding case-related overload to TreeMaker

Sep 6 '18; API spec. version: 1.2.39; affected top-level classes: TreeUtilities; made by: jlahoda
Added TreeMaker.CaseMultipleLabels(List<? extends ExpressionTree> patterns, List<? extends StatementTree> statements) and TreeMaker.Case(List<? extends ExpressionTree> patterns, Tree body) overloads.

Check the tree has compile error in given collection of errors.

Jul 18 '18; API spec. version: 1.2.37; affected top-level classes: TreeUtilities; made by: vikasprabhakar
Check the tree has compile error in given collection of errors.

Check the tree is the end of compound declaration.

May 14 '18; API spec. version: 1.2.34; affected top-level classes: TreeUtilities; made by: arusinha
Check whether tree is part of compound declaration.

Check the tree is the end of compound declaration.

May 3 '18; API spec. version: 1.2.33; affected top-level classes: TreeUtilities; made by: vikasprabhakar
Check the tree end with comma.

Check the var type variable in given tree path.

Apr 20 '18; API spec. version: 1.2.32; affected top-level classes: TreeUtilities; made by: jlahoda
Added BuildArtifactMapper.isCompileOnSaveSupported method, which checks if compile on save is suported in the current configuration.

Check the var type variable in given tree path.

Mar 27 '18; API spec. version: 1.2.31; affected top-level classes: TreeUtilities; made by: vikasprabhakar
Check the var type variable in given tree path.

Added a method to create an `ElementHandle` for module

Jan 17 '17; API spec. version: 1.2.26; affected top-level classes: ElementHandle; made by: tzezula
Added a method to create a module ElementHandle from a module name.

Added methods to generate/modify the module-info.java files

Oct 4 '16; API spec. version: 1.2.23; affected top-level classes: TypesEvent; made by: dbalek
Added methods to generate/modify the module-info.java files

Added an information about changes in the module-info

Oct 4 '16; API spec. version: 1.2.23; affected top-level classes: TypesEvent; made by: tzezula
Added an information about changes in the module-info.

List elements with their definining Scope

May 31 '16; API spec. version: 1.2.16; affected top-level classes: ElementUtilities; made by: sdedic; issues: #262281
Allows to enumerate Elements matching passed ElementFilter according to hiding and inheritance rules. The method may be useful to list elements matching certain criteria, or to check whether an element exists and find what class/method defined it.

Provide type suitable for declaration in source

May 16 '16; API spec. version: 1.2.17; affected top-level classes: TypeUtilities; made by: sdedic; issues: #262073
Support method which allows to infer a type suitable for use in symbol declaration in the source was added.

Allow to return also unimplemented default methods

May 10 '16; API spec. version: 1.2.15; affected top-level classes: ElementUtilities; made by: sdedic; issues: #258981

findUnimplementedMethods and findOverridableMethods work better with interface default methods: they are treated as implemented, but overridable.

Allow ElementUtilities.findUnimplementedMethods enumerate also default methods whose implementations are not provided by class or superclasses.

Code Generator uses caret location to insert members

Oct 5 '15; API spec. version: 1.2.11; affected top-level classes: CodeStyle; made by: ralphbenjamin; issues: #255214
Added an overloaded method to Code Generator should to include the caret location when inserting members. This will be used when the codestyle is CodeStyle.InsertionPoint.CARET_LOCATION.

ClassIndex SearchKind extended by FUNCTIONAL_IMPLEMENTORS

Sep 23 '15; API spec. version: 1.2.9; affected top-level classes: ClassIndex; made by: tzezula; issues: #255393
Added a possibility to ClassIndex to search a lambda implementations.

ClassIndex returns resources from binaryroots

Jun 27 '15; API spec. version: 1.2.6; affected top-level classes: ClassIndex; made by: ralphbenjamin; issues: #252992
ClassIndex holds information from different types of roots. Added a parameter to ClassIndex#getResources to specify which roots to use for its results.

Code Generator uses dependencies between fields

Feb 9 '15; API spec. version: 1.2.2; affected top-level classes: CodeStyle; made by: sdedic; issues: #249199
Proper textual order of members should be used when inserting a field or class/interface initializer. The analysis could be optionally turned off.

Remove dependency on Openide Text API

May 25 '14; API spec. version: 1.1; affected top-level classes: ModificationResult; made by: sdedic; issues: #244744

OpenIDE Text API dependencies are removed, affecting ModificationResult.Difference API class, whose interface changed incompatibly. The class now returns java.swing.text.Position instead of org.openide.text.PositionRef for the start and end positions.

For binary compatibility, an additional module java.source.compat8 was created, which provides compatible method that still returns PositionRef

Binary-compatible

Desktop independent parts of the Java Source module extracted

Apr 30 '14; API spec. version: 1.0; made by: dbalek

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.

Compatibility:
Binary-compatible