com.sun.jdi.connect
Interface LaunchingConnector
- public abstract interface LaunchingConnector
- extends Connector
A connector which can launch a target VM before connecting to it.
- Since:
- 1.3
Method Summary |
VirtualMachine |
launch(java.util.Map arguments)
Launches an application and connects to its VM. |
launch
public VirtualMachine launch(java.util.Map arguments)
throws java.io.IOException,
IllegalConnectorArgumentsException,
VMStartException
- Launches an application and connects to its VM. Properties
of the launch (possibly including options,
main class, and arguments) are specified in
arguments
.
The argument map associates argument name strings to instances
of Connector.Argument
. The default argument map for a
connector can be obtained through Connector.defaultArguments()
.
Argument map values can be changed, but map entries should not be
added or deleted.
Important note: If a target VM is launched through this
funcctions, its output and error streams must be read as it
executes. These streams are available through the
Process object returned by
VirtualMachine.process()
. If the streams are not periodically
read, the target VM will stop executing when the buffers for these
streams are filled.
- Parameters:
arguments
- the argument map to be used in launching the VM.- Returns:
- the
VirtualMachine
mirror of the target VM. - Throws:
- java.io.IOException - when unable to launch.
Specific exceptions are dependent on the Connector implementation
in use.
- IllegalConnectorArgumentsException - when one of the
connector arguments is invalid.
- VMStartException - when the VM was successfully launched, but
terminated with an error before a connection could be established.