public class

SunCommandLineLauncher

extends Object
implements Connector LaunchingConnector
java.lang.Object
   ↳ com.sun.tools.jdi.SunCommandLineLauncher

Summary

Public Constructors
SunCommandLineLauncher()
Public Methods
Map<String, Connector.Argument> defaultArguments()
Returns the arguments accepted by this Connector and their default values.
String description()
Returns a human-readable description of this connector and its purpose.
VirtualMachine launch(Map<String, ? extends Connector.Argument> arguments)
Launches an application and connects to its VM.
String name()
Returns a short identifier for the connector.
String toString()
Returns a string representation of the object.
Transport transport()
Returns the transport mechanism used by this connector to establish connections with a target VM.
Protected Methods
VirtualMachine launch(String[] commandArray, String address, TransportService.ListenKey listenKey, TransportService ts)
[Expand]
Inherited Methods
From class java.lang.Object
From interface com.sun.jdi.connect.Connector
From interface com.sun.jdi.connect.LaunchingConnector

Public Constructors

public SunCommandLineLauncher ()

Public Methods

public Map<String, Connector.Argument> defaultArguments ()

Returns the arguments accepted by this Connector and their default values. The keys of the returned map are string argument names. The values are Connector.Argument containing information about the argument and its default value.

Returns
  • the map associating argument names with argument information and default value.

public String description ()

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

Returns
  • the description of this connector

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

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 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 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
Throws
IOException
IllegalConnectorArgumentsException
VMStartException

public String 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.

Returns
  • the name of this connector.

public String toString ()

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of: 

 getClass().getName() + '@' + Integer.toHexString(hashCode())

Returns
  • a string representation of the object.

public Transport transport ()

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

Returns

Protected Methods

protected VirtualMachine launch (String[] commandArray, String address, TransportService.ListenKey listenKey, TransportService ts)

Throws
IOException
VMStartException