|
Eclipse JDT Release 3.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Represents a particular type of VM for which there may be any number of VM installations. An example of a VM type is the standard JRE which might have instances corresponding to different installed versions such as JRE 1.2.2 and JRE 1.3.
This interface is intended to be implemented by clients that contribute
to the "org.eclipse.jdt.launching.vmType"
extension point.
IVMInstall
Method Summary | |
IVMInstall |
createVMInstall(String id)
Creates a new instance of this VM Install type. |
File |
detectInstallLocation()
Tries to detect an installed VM that matches this VM install type. |
void |
disposeVMInstall(String id)
Remove the VM associated with the given id from the set of VMs managed by this VM type. |
IVMInstall |
findVMInstall(String id)
Finds the VM with the given id. |
IVMInstall |
findVMInstallByName(String name)
Finds the VM with the given name. |
LibraryLocation[] |
getDefaultLibraryLocations(File installLocation)
Returns a collection of LibraryLocation s that represent the
default system libraries of this VM install type, if a VM was installed
at the given installLocation .
|
String |
getId()
Returns the globally unique id of this VM type. |
String |
getName()
Returns the display name of this VM type. |
IVMInstall[] |
getVMInstalls()
Returns all VM instances managed by this VM type. |
IStatus |
validateInstallLocation(File installLocation)
Validates the given location of a VM installation. |
Method Detail |
public IVMInstall createVMInstall(String id)
id
- An id String that must be unique within this IVMInstallType.
IllegalArgumentException
- If the id exists already.public IVMInstall findVMInstall(String id)
id
- the VM id
null
if not foundpublic IVMInstall findVMInstallByName(String name)
name
- the VM name
null
if not foundpublic void disposeVMInstall(String id)
id
- the id of the VM to be disposed.public IVMInstall[] getVMInstalls()
public String getName()
public String getId()
public IStatus validateInstallLocation(File installLocation)
For example, an implementation might check whether the VM executeable is present.
installLocation
- the root directory of a potential installation for
this type of VM
public File detectInstallLocation()
null
if they
can't assure that a given vm install matches this IVMInstallType.
null
if unable
to locate an installed VM.public LibraryLocation[] getDefaultLibraryLocations(File installLocation)
LibraryLocation
s that represent the
default system libraries of this VM install type, if a VM was installed
at the given installLocation
.
The returned LibraryLocation
s may not exist if the
installLocation
is not a valid install location.
installLocation
- home location
installLocation
.LibraryLocation
,
validateInstallLocation(File)
|
Eclipse JDT Release 3.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |