Interface Connector

All Known Subinterfaces:
AttachingConnector, LaunchingConnector, ListeningConnector
public interface Connector
A method of connection between a debugger and a target VM. A connector encapsulates exactly one Transport. used to establish the connection. Each connector has a set of arguments which controls its operation. The arguments are stored as a map, keyed by a string. Each implementation defines the string argument keys it accepts.
Since:
1.3
See Also:

Nested Class Summary

Modifier and Type Interface Description
static interface  Connector.Argument
Specification for and value of a Connector argument.
static interface  Connector.BooleanArgument
Specification for and value of a Connector argument, whose value is Boolean.
static interface  Connector.IntegerArgument
Specification for and value of a Connector argument, whose value is an integer.
static interface  Connector.SelectedArgument
Specification for and value of a Connector argument, whose value is a String selected from a list of choices.
static interface  Connector.StringArgument
Specification for and value of a Connector argument, whose value is a String.

Method Summary

Modifier and Type Method Description
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.
String name()
Returns a short identifier for the connector.
Transport transport()
Returns the transport mechanism used by this connector to establish connections with a target VM.

Method Details

name

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.

description

String description()
Returns a human-readable description of this connector and its purpose.
Returns:
the description of this connector

transport

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

defaultArguments

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.

© 1993, 2021, 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/17/docs/api/jdk.jdi/com/sun/jdi/connect/Connector.html