当前页面:
在线文档首页 >
JDK 5 Documentation v6.0, Java 2 SDK 英文文档
AttachingConnector (Java Debug Interface) - JDK 5 Documentation v6.0, Java 2 SDK 英文文档
com.sun.jdi.connect
Interface AttachingConnector
- All Superinterfaces:
- Connector
public interface AttachingConnector
- extends Connector
A connector which attaches to a previously running target VM.
- Since:
- 1.3
attach
VirtualMachine attach(Map<String,? extends Connector.Argument> arguments)
throws IOException,
IllegalConnectorArgumentsException
- Attaches to a running application and 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
- the argument map to be used in launching the VM.
- Returns:
- the
VirtualMachine
mirror of the target VM.
- Throws:
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.
IOException
- when unable to attach.
Specific exceptions are dependent on the Connector implementation
in use.
IllegalConnectorArgumentsException
- when one of the
connector arguments is invalid.