APIdia Launch Partner
Top Description Methods
com.sun.jdi.connect

public Interface AttachingConnector

extends Connector
Known Direct Implementers
com.sun.tools.jdi.GenericAttachingConnector, com.sun.tools.jdi.ProcessAttachingConnector
Imports
java.io.IOException, java.util.Map, com.sun.jdi.VirtualMachine
A connector which attaches to a previously running target VM.
Author
Gordon Hirsch
Since
1.3

Method Summary

Modifier and TypeMethod and Description
public VirtualMachine

Returns:

the VirtualMachine mirror of the target VM.
attach(Map<String, ? extends Connector.Argument>
the argument map to be used in launching the VM.
arguments)

Attaches to a running application and returns a mirror of its VM.

Inherited from com.sun.jdi.connect.Connector:
defaultArgumentsdescriptionnametransport

Method Detail

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

Attaches to a running application and returns a mirror of its VM.

The connector uses the given argument map in attaching the application. These arguments will include addressing information that identifies the VM. 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.

Parameters
arguments:Map<String, ? extends Connector.Argument>

the argument map to be used in launching the VM.

Returns:VirtualMachine

the VirtualMachine mirror of the target VM.

Exceptions
IOException:
when unable to attach. Specific exceptions are dependent on the Connector implementation in use.
IllegalConnectorArgumentsException:
when one of the connector arguments is invalid.
TransportTimeoutException:
when the Connector encapsulates a transport that supports a timeout when attaching, a Connector.Argument representing a timeout has been set in the argument map, and a timeout occurs when trying to attach to the target VM.