W3cubDocs

/OpenJDK 21

Interface AttachingConnector

All Superinterfaces:
Connector
public interface AttachingConnector extends Connector
A connector which attaches to a previously running target VM.
Since:
1.3

Nested Class Summary

Method Summary

Modifier and Type Method Description
VirtualMachine attach(Map<String,? extends Connector.Argument> arguments)
Attaches to a running application and returns a mirror of its VM.

Methods declared in interface com.sun.jdi.connect.Connector

defaultArguments, description, name, transport

Method Details

attach

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

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/jdk.jdi/com/sun/jdi/connect/AttachingConnector.html