Represents one NetBeans platform, i.e. installation of the NB platform or IDE
or some derivative product.
Has a code id and can have associated sources and Javadoc, just like e.g. Java platforms.
author: Jesse Glick
addPlatform(String id, File destdir, String label) Register a new platform.
Parameters: id - unique ID string for the platform Parameters: destdir - destination directory (i.e.
addPlatform(String id, File destdir, File harness, String label) Register a new platform.
Parameters: id - unique ID string for the platform Parameters: destdir - destination directory (i.e.
getJavadocRoots() Get associated Javadoc roots for this platform.
Each root may contain some Javadoc sets in the usual format as subdirectories,
where the subdirectory is named acc.
Add given javadoc root to the current javadoc root list and save the
result into the global properties in the userdir (see
PropertyUtils.putGlobalProperties )
Register a new platform.
Parameters: id - unique ID string for the platform Parameters: destdir - destination directory (i.e. top-level directory beneath which there are clusters) Parameters: label - display label the created platform throws: IOException - in case of problems (e.g. destination directory does not exist)
Register a new platform.
Parameters: id - unique ID string for the platform Parameters: destdir - destination directory (i.e. top-level directory beneath which there are clusters) Parameters: harness - harness directory Parameters: label - display label the created platform throws: IOException - in case of problems (e.g. destination directory does not exist)
Add given source root to the current source root list and save the
result into the global properties in the userdir (see
PropertyUtils.putGlobalProperties )
Get a unique ID for this platform.
Used e.g. in nbplatform.active in platform.properties.
a unique ID, or null for anonymousplatforms (see NbPlatform.getPlatformByDestDir).
Get associated Javadoc roots for this platform.
Each root may contain some Javadoc sets in the usual format as subdirectories,
where the subdirectory is named acc. to the code name base of the module it
is documenting (using '-' in place of '.').
a list of Javadoc root URLs (may be empty but not null)
Returns (naturally sorted) array of all module entries pertaining to
this NetBeans platform. This is just a convenient delegate
to the
ModuleList.findOrCreateModuleListFromBinaries .
Find a platform by its installation directory.
If there is a registered platform for that directory, returns it.
Otherwise will create an anonymous platform (
NbPlatform.getID will be null).
An anonymous platform might have sources associated with it;
currently this will be true in case the dest dir is nbbuild/netbeans/ inside a netbeans.org checkout.
Parameters: the - installation directory (as in NbPlatform.getDestDir) the platform with that destination directory
Find sources for a module JAR file contained in this destination directory.
Parameters: jar - a JAR file in the destination directory the directory of sources for this module (a project directory), or null
Get associated source roots for this platform.
Each root could be a netbeans.org source checkout or a module suite project directory.
a list of source root URLs (may be empty but not null)
Check whether a given directory is really a valid harness.
isLabelValid
public static boolean isLabelValid(String supposedLabel)(Code)
Returns whether the given label (see
NbPlatform.getLabel ) is valid.
Valid label must be non-null and must not be used by any
already defined platform.
isPlatformDirectory
public static boolean isPlatformDirectory(File destdir)(Code)
Check whether a given directory on disk is a valid destdir as per
NbPlatform.getDestDir .
Parameters: destdir - a candidate directory true if it can be used as a platform
isSupportedPlatform
public static boolean isSupportedPlatform(File destdir)(Code)
Remove given javadoc roots from the current javadoc root list and save
the result into the global properties in the userdir (see
PropertyUtils.putGlobalProperties )
Remove given source roots from the current source root list and save the
result into the global properties in the userdir (see
PropertyUtils.putGlobalProperties )