|
JavaScript Development Tools Release 3.2 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IVMInstall
Represents a particular installation of a VM. A VM instance holds all parameters specific to a VM installation. Unlike VM types, VM instances can be created and configured dynamically at run-time. This is typically done by the user interactively in the UI.
A VM install is responsible for creating VM runners to launch a JavaScript program in a specific mode.
This interface is intended to be implemented by clients that contribute
to the "org.eclipse.wst.jsdt.launching.vmInstallTypes"
extension point.
Rather than implementing this interface directly, it is strongly recommended that
clients subclass AbstractVMInstall
to be insulated
from potential API additions. In 3.1, a new optional interface has been added for
implementors of this interface - IVMInstall2
.
The new interface is implemented by AbstractVMInstall
.
Provisional API: This class/interface is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
Method Summary | |
---|---|
String |
getId()
Returns the id for this VM. |
File |
getInstallLocation()
Returns the root directory of the install location of this VM. |
URL |
getJavadocLocation()
Returns the jsdoc location associated with this VM install. |
LibraryLocation[] |
getLibraryLocations()
Returns the library locations of this IVMInstall. |
String |
getName()
Returns the display name of this VM. |
String[] |
getVMArguments()
Returns VM arguments to be used with this vm install whenever this VM is launched as they should be passed to the command line, or null if none. |
IVMInstallType |
getVMInstallType()
Returns the VM type of this VM. |
IVMRunner |
getVMRunner(String mode)
Returns a VM runner that runs this installed VM in the given mode. |
void |
setInstallLocation(File installLocation)
Sets the root directory of the install location of this VM. |
void |
setJavadocLocation(URL url)
Sets the jsdoc location associated with this VM install. |
void |
setLibraryLocations(LibraryLocation[] locations)
Sets the library locations of this IVMInstall. |
void |
setName(String name)
Sets the display name of this VM. |
void |
setVMArguments(String[] vmArgs)
Deprecated. if possible, clients should use setVMArgs(String) on IVMInstall2 when possible |
Method Detail |
---|
IVMRunner getVMRunner(String mode)
mode
- the mode the VM should be launched in; one of the constants
declared in org.eclipse.debug.core.ILaunchManager
null
if the given mode
is not supported by this VM.org.eclipse.debug.core.ILaunchManager
String getId()
null
.String getName()
null
.void setName(String name)
name
- the display name of this VMFile getInstallLocation()
null
.void setInstallLocation(File installLocation)
installLocation
- the root directory of this VM installationIVMInstallType getVMInstallType()
LibraryLocation[] getLibraryLocations()
JavaRuntime.getLibraryLocations(IVMInstall)
to determine the libraries associated with this VM install.
null
to indicate that this VM install uses
the default library locations associated with this VM's install type.setLibraryLocations(LibraryLocation[])
void setLibraryLocations(LibraryLocation[] locations)
locations
- The LibraryLocation
s to associate
with this IVMInstall.
May be null
to indicate that this VM install uses
the default library locations associated with this VM's install type.void setJavadocLocation(URL url)
url
- a url pointing to the jsdoc location associated with
this VM installURL getJavadocLocation()
null
if noneString[] getVMArguments()
null
if none.
null
if nonevoid setVMArguments(String[] vmArgs)
IVMInstall2
when possible
null
. This is equivalent
to setVMArgs(String)
with whitespace character delimited
arguments.
vmArgs
- VM arguments to be used with this vm install whenever this
VM is launched, possibly null
|
JavaScript Development Tools Release 3.2 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |