APIdia Launch Partner
Top Fields Constructors Methods
com.sun.tools.jdi

public Class RawCommandLineLauncher

extends AbstractLauncher
Class Inheritance
Imports
java.io.IOException, java.lang.reflect.InvocationTargetException, java.util.Map, com.sun.jdi.VirtualMachine, com.sun.jdi.connect.Connector, .IllegalConnectorArgumentsException, .Transport, .VMStartException, com.sun.jdi.connect.spi.TransportService

Field Summary

Modifier and TypeField and Description
private static final String
private static final String
private static final String
pack-priv Transport
pack-priv TransportService
Inherited from com.sun.tools.jdi.AbstractLauncher:
grp

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public String
description()

Implements abstract com.sun.tools.jdi.AbstractLauncher.description.

Implements com.sun.jdi.connect.Connector.description.

Returns a human-readable description of this connector and its purpose.

public VirtualMachine
launch(Map<String, ? extends Connector.Argument> arguments)

Implements abstract com.sun.tools.jdi.AbstractLauncher.launch.

Implements com.sun.jdi.connect.LaunchingConnector.launch.

Launches an application and connects to its VM.

public String
name()

Implements abstract com.sun.tools.jdi.AbstractLauncher.name.

Implements com.sun.jdi.connect.Connector.name.

Returns a short identifier for the connector.

public Transport
transport()

Implements com.sun.jdi.connect.Connector.transport.

Returns the transport mechanism used by this connector to establish connections with a target VM.

public TransportService
Inherited from com.sun.tools.jdi.AbstractLauncher:
launchtokenizeCommand

Field Detail

ARG_ADDRESSback to summary
private static final String ARG_ADDRESS
ARG_COMMANDback to summary
private static final String ARG_COMMAND
ARG_QUOTEback to summary
private static final String ARG_QUOTE
transportback to summary
pack-priv Transport transport
transportServiceback to summary
pack-priv TransportService transportService

Constructor Detail

RawCommandLineLauncherback to summary
public RawCommandLineLauncher()

Method Detail

descriptionback to summary
public String description()

Implements abstract com.sun.tools.jdi.AbstractLauncher.description.

Implements com.sun.jdi.connect.Connector.description.

Doc from com.sun.jdi.connect.Connector.description.

Returns a human-readable description of this connector and its purpose.

launchback to summary
public VirtualMachine launch(Map<String, ? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException, VMStartException

Implements abstract com.sun.tools.jdi.AbstractLauncher.launch.

Implements com.sun.jdi.connect.LaunchingConnector.launch.

Doc from com.sun.jdi.connect.LaunchingConnector.launch.

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

Exceptions
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.
nameback to summary
public String name()

Implements abstract com.sun.tools.jdi.AbstractLauncher.name.

Implements com.sun.jdi.connect.Connector.name.

Doc from com.sun.jdi.connect.Connector.name.

Returns a short identifier for the connector. Connector implementors should follow similar naming conventions as are used with packages to avoid name collisions. For example, the Sun connector implementations have names prefixed with "com.sun.jdi.". Not intended for exposure to end-user.

transportback to summary
public Transport transport()

Implements com.sun.jdi.connect.Connector.transport.

Doc from com.sun.jdi.connect.Connector.transport.

Returns the transport mechanism used by this connector to establish connections with a target VM.

transportServiceback to summary
public TransportService transportService()