Home » openjdk-7 » com.sun » jdi » connect » [javadoc | source]
com.sun.jdi.connect
public interface: LaunchingConnector [javadoc | source]

All Implemented Interfaces:
    Connector

All Known Implementing Classes:
    AbstractLauncher, SunCommandLineLauncher, RawCommandLineLauncher

A connector which can launch a target VM before connecting to it.
Method from com.sun.jdi.connect.LaunchingConnector Summary:
launch
Method from com.sun.jdi.connect.LaunchingConnector Detail:
 public VirtualMachine launch(Map<String, Argument> arguments) throws 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.

    A target VM launched by a launching connector is not guaranteed to be stable until after the com.sun.jdi.event.VMStartEvent has been received.

    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 com.sun.jdi.VirtualMachine#process . If the streams are not periodically read, the target VM will stop executing when the buffers for these streams are filled.