Overview (Java Platform)

Java Platform
Package	Description
org.netbeans.api.java.platform	Representation of Java platform installations.
org.netbeans.spi.java.platform
org.netbeans.spi.java.platform.support

JavaPlatformAPI The Java Platform API permits access to installed Java platforms (for example, the J2SE JDK, or various mobile-device emulators for J2ME). Particular platform types are registered by modules and can store customized information about the platform to disk.
Note that this module concentrates the part of th API which is independent of the client desktop (and Swing UI library) environment. Its desktop-dependent counterpart is in the org.netbeans.modules.java.platform.ui module.

What is New (see all changes)?

Apr 3 '17 Added a isValid method into JavaPlatform

Added a isValid method into JavaPlatform to check platform validity. The platform is non valid when it's deleted or an platform tool (java, javac) is missing or bootstrap libraries are missing.
Aug 17 '16 Added a SPI to create new JavaPlatform

Added a SPI allowing JavaPlatform implementors to export ability to create a new JavaPlatform.
May 14 '14 Desktop dependent java platform UI extracted

The following classes were moved into the org.netbeans.java.platform.ui module:
Jun 13 '12 Added Specification.getDisplayName returning the user friendly name of the platform specification.
Added Specification.getDisplayName returning the user friendly name of the platform specification.
Apr 12 '06

JavaPlatformManager.getDefaultPlatform could formerly return null, in case no installed providers returned an instance; typically this would be due to some storage problem. In the interests of robustness, it will now as a fallback return a simple platform instance corresponding the JRE hosting the NetBeans code. Optional capabilities may be missing so avoid relying on this fallback platform implementation.

Use Cases

The API can be used by any code wishing to know the list of installed platforms and information about each one; typically this would be used by project type providers to implement a customizer dialog. The SPI is intended to be implemented by a few modules supply support for locating and introspecting installed platforms, for example a JDK setup wizard.

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?

JavaPlatformAPI

Exported

Official

The Java Platform API permits access to installed Java platforms (for example, the J2SE JDK, or various mobile-device emulators for J2ME). Particular platform types are registered by modules and can store customized information about the platform to disk.
Note that this module concentrates the part of th API which is independent of the client desktop (and Swing UI library) environment. Its desktop-dependent counterpart is in the org.netbeans.modules.java.platform.ui module.

Implementation Details

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.