Change History for the Java Source API - NetBeans API Javadoc (Current Development Version)

Introduction

This document lists changes made to the Java Source API.

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.

All changes by date

(Apr 24 '07) Added factory method which returns a new TreePathHandle for given Element and CompilationInfo.
(Apr 19 '07) Added a method to run a CancellableTask when the backgound scan is finished.
(Apr 13 '07) Added a method which returns all the project source roots depending on a given source root.
(Apr 4 '07) Added a listener for listening on changes in the ClassIndex.
(Mar 26 '07) Adding template attribute package
(Mar 18 '07) Removing CommentUtilities, adjusting TreeMaker and introducing TypeUtilities

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: org.netbeans.modules.java.source > 1.20

(0.13) Added factory method which returns a new TreePathHandle for given Element and CompilationInfo.
(0.12) Added a method to run a CancellableTask when the backgound scan is finished.
(0.10) Added a method which returns all the project source roots depending on a given source root.
(0.8) Added a listener for listening on changes in the ClassIndex.
(0.7) Adding template attribute package
(0.6) Removing CommentUtilities, adjusting TreeMaker and introducing TypeUtilities

Changes by affected class

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

(Mar 18 '07) Removing CommentUtilities, adjusting TreeMaker and introducing TypeUtilities

Details of all changes by API and date

Java Source API

Added factory method which returns a new TreePathHandle for given Element and CompilationInfo.

Apr 24 '07; API spec. version: 0.13; made by: jbecicka; issues: #102333
There is no simple way how to weakly reference all elements from javac. For instance local variables cannot be referenced by ElementHandles while source-less Elements cannot be referenced by TreePathHandles. This fix allows to create TreePathHandles for any javac Element (both local and source less).

Added a method to run a CancellableTask when the backgound scan is finished.

Apr 19 '07; API spec. version: 0.12; made by: tzezula; issues: #91117 #99923
The JavaSource.runWhenScanFinished performs the given task either synchronously when no background scan is running. When the background scan is running the task is performed asynchronously when the scan completes.

Added a method which returns all the project source roots depending on a given source root.

Apr 13 '07; API spec. version: 0.10; made by: tzezula; issues: #92030
The refactoring and find usages need to find the dependent roots of a project root in which the refactored type is declared, but finding such an information using the project API may be very expensive especially when lots of projects is opened. The goal of this API is to provide and cache this information.

Added a listener for listening on changes in the `ClassIndex`.

Apr 4 '07; API spec. version: 0.8; made by: tzezula; issues: #91763
The listener for listening on changes in the ClassIndex was added. The listener fires events when a declared type was removed, added, changed in the ClassIndex oe when the underlaying ClassPath was changed.

Adding template attribute `package`

Mar 26 '07; API spec. version: 0.7; made by: jpokorsky; issues: #95399
Added the template attribute package for templates using scripting language.

Removing CommentUtilities, adjusting TreeMaker and introducing TypeUtilities

Mar 18 '07; API spec. version: 0.6; affected top-level classes: TypeUtilities; made by: jlahoda; issues: #97542

removed org.netbeans.api.java.source.CommentUtilities
removed org.netbeans.api.java.source.TreeMaker.Variable(..., TypeElement)
removed org.netbeans.api.java.source.TreeMaker.Method(..., TypeElement)
added org.netbeans.api.java.source.TypeUtilities

Compatibility: