Introduction

This document lists changes made to the Java Common API.

Index of APIs

Java Common 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

(May 20 '12) Added PlatformUiSupport.storePlatform with updatePreferredPlatform parameter
(Apr 25 '11) Added methods to track ant invocation
(Jul 8 '10) Added a factory method to create SourceLevelQueryImplementation2
(Jun 3 '10) Support for mutable Sources
(Jun 1 '10) BaseActionProvider introduced
(May 18 '10) Reusable implementation of ProjectInformation
(Jan 26 '10) Support for AnnotationProcessingQuery
(Oct 7 '09) Add support for endorsed libraries
(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

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.api.common > 1.20

(1.37) Added PlatformUiSupport.storePlatform with updatePreferredPlatform parameter
(1.29) Added methods to track ant invocation
(1.22) Added a factory method to create SourceLevelQueryImplementation2
(1.21) Support for mutable Sources
(1.20) BaseActionProvider introduced
(1.18) Reusable implementation of ProjectInformation
(1.14) Support for AnnotationProcessingQuery
(1.11) Add support for endorsed libraries
(1.5) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

Changes by affected class

`org.netbeans.modules.java.api.common.project.ui.customizer.AntArtifactItem`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.BaseActionProvider`

(Apr 25 '11) Added methods to track ant invocation
(Jun 1 '10) BaseActionProvider introduced

`org.netbeans.modules.java.api.common.classpath.ClassPathExtender`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.ui.customizer.ClassPathListCellRenderer`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.classpath.ClassPathModifier`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.classpath.ClassPathModifierSupport`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.classpath.ClassPathProviderImpl`

(Jan 26 '10) Support for AnnotationProcessingQuery
(Oct 7 '09) Add support for endorsed libraries
(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.classpath.ClassPathSupport`

(Oct 7 '09) Add support for endorsed libraries
(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.classpath.ClassPathSupportFactory`

(Oct 7 '09) Add support for endorsed libraries
(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.ui.ClassPathUiSupport`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.ui.customizer.CustomizerProvider2`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.ui.customizer.EditMediator`

(Jan 26 '10) Support for AnnotationProcessingQuery
(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.ui.JavaSourceNodeFactory`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.ui.LibrariesNode`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.ui.LogicalViewProvider2`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.ui.PlatformUiSupport`

(May 20 '12) Added PlatformUiSupport.storePlatform with updatePreferredPlatform parameter

`org.netbeans.modules.java.api.common.project.ProjectProperties`

(Jan 26 '10) Support for AnnotationProcessingQuery
(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.project.ui.ProjectUISupport`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

`org.netbeans.modules.java.api.common.queries.QuerySupport`

(Jul 8 '10) Added a factory method to create SourceLevelQueryImplementation2
(Jun 3 '10) Support for mutable Sources
(May 18 '10) Reusable implementation of ProjectInformation
(Jan 26 '10) Support for AnnotationProcessingQuery

`org.netbeans.modules.java.api.common.Roots`

(Jun 3 '10) Support for mutable Sources

`org.netbeans.modules.java.api.common.project.ui.customizer.SourceRootsUi`

(Oct 28 '08) Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

Details of all changes by API and date

Java Common API

Added `PlatformUiSupport.storePlatform` with `updatePreferredPlatform` parameter

May 20 '12; API spec. version: 1.37; affected top-level classes: PlatformUiSupport; made by: tzezula; issues: #208528

Added PlatformUiSupport.storePlatform with updatePreferredPlatform parameter allowing the API clients to specify if the PreferredProjectPlatform should be updated.

Added methods to track ant invocation

Apr 25 '11; API spec. version: 1.29; affected top-level classes: BaseActionProvider; made by: phejl; issues: #197838

Added methods to track ant invocation from subclasses.

Added a factory method to create SourceLevelQueryImplementation2

Jul 8 '10; API spec. version: 1.22; affected top-level classes: QuerySupport; made by: tzezula; issues: #185031

Added a factory method to create default ant project based SourceLevelQueryImplementation2.

Support for mutable Sources

Jun 3 '10; API spec. version: 1.21; affected top-level classes: Roots QuerySupport; made by: tzezula; issues: #148320

Adding a factory method for creating a mutable Sources implemenation which allows adding (removing) of roots.

BaseActionProvider introduced

Jun 1 '10; API spec. version: 1.20; affected top-level classes: BaseActionProvider; made by: dkonecny; issues: #171153

J2SE implementations of ActionProvider was turned into friend API so that EE project types can reuse most of Java specific code without duplicating it.

Reusable implementation of ProjectInformation

May 18 '10; API spec. version: 1.18; affected top-level classes: QuerySupport; made by: mvfranz; issues: #110886

Created a reusable implementation of ProjectInformation that can be used within the Java language projects. Provide two factory methods for creation in QuerySupport, one that uses AntProjectHelper and one that uses UpdateHelper.

Support for AnnotationProcessingQuery

Jan 26 '10; API spec. version: 1.14; affected top-level classes: ClassPathProviderImpl ProjectProperties EditMediator QuerySupport; made by: jlahoda; issues: #179749

Adding support for AnnotationProcessingQuery, and related API changes.

Add support for endorsed libraries

Oct 7 '09; API spec. version: 1.11; affected top-level classes: ClassPathSupportFactory ClassPathSupport ClassPathProviderImpl; made by: dkonecny; issues: #172952

Add ability to create bootclasspath with given endorsed libraries.

Refactor reusable code from J2SE project type and make it available for other project types (eg. J2EE/Web).

Oct 28 '08; API spec. version: 1.5; affected top-level classes: ClassPathExtender ClassPathModifier ClassPathModifierSupport ClassPathProviderImpl ClassPathSupportFactory ClassPathSupport ProjectProperties ClassPathUiSupport JavaSourceNodeFactory LibrariesNode LogicalViewProvider2 ProjectUISupport AntArtifactItem ClassPathListCellRenderer CustomizerProvider2 EditMediator SourceRootsUi; made by: dkonecny; issues: #150357

Make code implementing J2SE support in project type reusable. Originally around NetBeans 4.0 most of this code was copy and pasted from java.j2seproject to several other project types and kept in synch ever since. This change eliminates duplicity of the code and refactors as much of J2SE support specific code to java.api.common module as possible.