Representation of Java platform installations.
Registration of Java platform types.
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.
Specification.getDisplayNamereturning the user friendly name of the platform specification.
the user friendly name of the platform specification.
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.
There are some platform installers which does not use the local disk as source of the java platform, for example they download the java platform from the web. Such installers cannot use the current PlatformInstall which is file oriented. The CustomPlatformInstall allows to platform install provider to implement its own way of installing the new platform. The PlatformInstall is still supported. If the module provides the PlatformInstall in the global lookup, the java platform module does the java platform chooser for it, the behavior is not changed. If the module provides the CustomPlatformInstall in the global lookup, it has to do the platform selection by itself.
To indicate that this is now considered a stable API, the major release version was incremented to 1 from 0.
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.
Read more about the implementation in the answers to architecture questions.
Built on August 25 2014. | Portions Copyright 1997-2014 Oracle. All rights reserved.