Modifier and Type	Class and Description
private class	AbstractLauncher.Helper This class simply provides a context for a single launch and accept.

Modifier and Type	Field and Description
pack-priv ThreadGroup	grp

Access	Constructor and Description
pack-priv	AbstractLauncher()

Method Summary

Modifier and Type	Method and Description
public abstract String	description() Redeclares com.sun.jdi.connect.Connector.description. Returns a human-readable description of this connector and its purpose.
public abstract VirtualMachine	launch(Map<String, ? extends Connector.Argument> arguments) Redeclares com.sun.jdi.connect.LaunchingConnector.launch. Launches an application and connects to its VM.
protected VirtualMachine	launch(String[] commandArray, String address, TransportService.ListenKey listenKey, TransportService ts)
public abstract String	name() Redeclares com.sun.jdi.connect.Connector.name. Returns a short identifier for the connector.
pack-priv String[]	tokenizeCommand(String command, char quote)

Inherited from com.sun.tools.jdi.ConnectorImpl:: addBooleanArgument addIntegerArgument addSelectedArgument addStringArgument argument defaultArguments getString toString

grp	back to summary
pack-priv ThreadGroup grp

AbstractLauncher	back to summary
pack-priv AbstractLauncher()

Method Detail

description	back to summary
public abstract String description() Redeclares 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.

description

back to summary

public abstract String description()

Redeclares 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.

launch back to summary

launch	back to summary
public abstract VirtualMachine launch(Map<String, ? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException, VMStartException Redeclares 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.

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

Redeclares 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.

launch	back to summary
protected VirtualMachine launch(String[] commandArray, String address, TransportService.ListenKey listenKey, TransportService ts) throws IOException, VMStartException

name	back to summary
public abstract String name() Redeclares 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.

name

back to summary

public abstract String name()

Redeclares 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.

tokenizeCommand	back to summary
pack-priv String[] tokenizeCommand(String command, char quote)

com.sun.tools.jdi back to summary

private Class AbstractLauncher.Helper

Class Inheritance

extends Object

java.lang.Object
com.sun.tools.jdi.AbstractLauncher.Helper

This class simply provides a context for a single launch and accept. It provides instance fields that can be used by all threads involved. This stuff can't be in the Connector proper because the connector is a singleton and is not specific to any one launch.

Field Summary

Modifier and Type	Field and Description
private IOException	acceptException
private final String	address
private final String[]	commandArray
private Connection	connection
private boolean	exited
private TransportService.ListenKey	listenKey
private Process	process
private TransportService	ts

Constructor Summary

Access	Constructor and Description
pack-priv	Helper(String[] commandArray, String address, TransportService.ListenKey listenKey, TransportService ts)

Method Summary

Modifier and Type	Method and Description
pack-priv Thread	acceptConnection()
pack-priv String	commandString()
pack-priv Connection	connection()
pack-priv synchronized void	launchAndAccept()
pack-priv Thread	monitorTarget()
pack-priv synchronized void	notifyOfAcceptException(IOException acceptException)
pack-priv synchronized void	notifyOfConnection(Connection connection)
pack-priv synchronized void	notifyOfExit()
pack-priv Process	process()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

acceptException	back to summary
private IOException acceptException

address	back to summary
private final String address Annotations @SuppressWarnings:unused

commandArray	back to summary
private final String[] commandArray

connection	back to summary
private Connection connection

exited	back to summary
private boolean exited

listenKey	back to summary
private TransportService.ListenKey listenKey

process	back to summary
private Process process

ts	back to summary
private TransportService ts

Constructor Detail

Helper	back to summary
pack-priv Helper(String[] commandArray, String address, TransportService.ListenKey listenKey, TransportService ts)

Method Detail

acceptConnection	back to summary
pack-priv Thread acceptConnection()

commandString	back to summary
pack-priv String commandString()

connection	back to summary
pack-priv Connection connection()

launchAndAccept	back to summary
pack-priv synchronized void launchAndAccept() throws IOException, VMStartException

monitorTarget	back to summary
pack-priv Thread monitorTarget()

notifyOfAcceptException	back to summary
pack-priv synchronized void notifyOfAcceptException(IOException acceptException)

notifyOfConnection	back to summary
pack-priv synchronized void notifyOfConnection(Connection connection)

notifyOfExit	back to summary
pack-priv synchronized void notifyOfExit()

process	back to summary
pack-priv Process process()

pack-priv abstract Class AbstractLauncher

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class AbstractLauncher.Helper

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail