public class VMRunnerConfiguration extends Object
Clients may instantiate this class.
Constructor and Description |
---|
VMRunnerConfiguration(String classToLaunch,
String[] classPath)
Creates a new configuration for launching a VM to run the given main class
using the given class path.
|
Modifier and Type | Method and Description |
---|---|
String[] |
getBootClassPath()
Returns the boot classpath.
|
String[] |
getClassPath()
Returns the classpath.
|
String |
getClassToLaunch()
Returns the name of the class to launch.
|
String[] |
getEnvironment()
Returns the environment for the Java program or
null |
String[] |
getProgramArguments()
Returns the arguments to the Java program.
|
String[] |
getVMArguments()
Returns the arguments to the VM itself.
|
Map<String,Object> |
getVMSpecificAttributesMap()
Returns the
Map that contains String name/value pairs that represent
VM-specific attributes. |
String |
getWorkingDirectory()
Returns the working directory of a launched VM.
|
boolean |
isResumeOnStartup()
Returns whether the VM is resumed on startup when launched
in debug mode.
|
void |
setBootClassPath(String[] bootClassPath)
Sets the boot classpath.
|
void |
setEnvironment(String[] environment)
Sets the environment for the Java program.
|
void |
setProgramArguments(String[] args)
Sets the custom program arguments.
|
void |
setResumeOnStartup(boolean resume)
Sets whether the VM is resumed on startup when launched in
debug mode.
|
void |
setVMArguments(String[] args)
Sets the custom VM arguments.
|
void |
setVMSpecificAttributesMap(Map<String,Object> map)
Sets the
Map that contains String name/value pairs that represent
VM-specific attributes. |
void |
setWorkingDirectory(String path)
Sets the working directory for a launched VM.
|
public VMRunnerConfiguration(String classToLaunch, String[] classPath)
classToLaunch
- The fully qualified name of the class to launch. May not be null.classPath
- The classpath. May not be null.public void setVMSpecificAttributesMap(Map<String,Object> map)
Map
that contains String name/value pairs that represent
VM-specific attributes.map
- the Map
of VM-specific attributes.public void setVMArguments(String[] args)
args
- the list of VM argumentspublic void setProgramArguments(String[] args)
args
- the list of argumentspublic void setEnvironment(String[] environment)
environment
- the environment for the Java program specified as an array
of strings, each element specifying an environment variable setting in the
format name=valuepublic void setBootClassPath(String[] bootClassPath)
In release 3.0, support has been added for appending and prepending the
boot classpath. Generally an IVMRunner
should use the prepend,
main, and append boot classpaths provided. However, in the case that an
IVMRunner
does not support these options, a complete bootpath
should also be specified.
bootClassPath
- The boot classpath. An empty array indicates an empty
bootpath and null
indicates a default bootpath.public Map<String,Object> getVMSpecificAttributesMap()
Map
that contains String name/value pairs that represent
VM-specific attributes.Map
of VM-specific attributes or null
.public String getClassToLaunch()
null
.public String[] getClassPath()
public String[] getBootClassPath()
null
indicates a default bootpath.
In 3.0, support has been added for prepending and appending to the
boot classpath. The new attributes are stored in the VM specific
attributes map using the following keys defined in
IJavaLaunchConfigurationConstants
:
null
indicates a default bootpath.setBootClassPath(String[])
,
IJavaLaunchConfigurationConstants
public String[] getVMArguments()
null
.setVMArguments(String[])
public String[] getProgramArguments()
null
.setProgramArguments(String[])
public String[] getEnvironment()
null
null
public void setWorkingDirectory(String path)
path
- the absolute path to the working directory
to be used by a launched VM, or null
if
the default working directory is to be inherited from the
current processpublic String getWorkingDirectory()
null
if the working
directory is inherited from the current processpublic void setResumeOnStartup(boolean resume)
resume
- whether to resume the VM on startuppublic boolean isResumeOnStartup()
true
for backwards compatibility.
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.