| org.eclipse.jdt.launching.IVMConnector
All known Subclasses: org.eclipse.jdt.internal.launching.SocketAttachConnector, org.eclipse.jdt.internal.launching.SocketListenConnector, org.eclipse.jdt.internal.launching.j9.J9ConnectorDelegate,
IVMConnector | public interface IVMConnector (Code) | | A VM connector establishes a JDI connection with a debuggable
virtual machine. This extension point provides a mechanism for
abstracting the connection to a remote virtual machine.
A VM connector extension is defined in plugin.xml .
Following is an example definition of a VM connector extension.
<extension point="org.eclipse.jdt.launching.vmConnectors">
<vmConnector
id="com.example.VMConnector"
class="com.example.VMConnectorClass"
</vmConnector>
</extension>
The attributes are specified as follows:
id specifies a unique identifier for this VM connector.
class specifies the fully qualified name of the Java class
that implements IVMConnector .
since: 2.0 |
Method Summary | |
public void | connect(Map arguments, IProgressMonitor monitor, ILaunch launch) Establishes a JDI connection with a debuggable VM using the arguments
specified in the given map, contributing results (debug targets and processes),
to the given launch.
Parameters: arguments - Argument map to use in establishing a connection. | public List | getArgumentOrder() Returns a list of argument names found in this connector's
default argument map, defining the order in which arguments
should be presented to the user. | public Map | getDefaultArguments() Returns a map of default arguments used by this connector. | public String | getIdentifier() Returns a unique identifier for this kind of connector. | public String | getName() Returns the name of this connector. |
connect | public void connect(Map arguments, IProgressMonitor monitor, ILaunch launch) throws CoreException(Code) | | Establishes a JDI connection with a debuggable VM using the arguments
specified in the given map, contributing results (debug targets and processes),
to the given launch.
Parameters: arguments - Argument map to use in establishing a connection. The keys ofthe map are strings corresponding to the names of arguments returned by thisconnector's getDefaultAgruments() method. The values of the mapare strings corresponding to the (String) values of the associatedcom.sun.jdi.connect.Connector.Argument s to use. Parameters: monitor - progress monitor Parameters: launch - launch to contribute debug target(s) and/or process(es) to exception: CoreException - if unable to establish a connection with the target VM |
getArgumentOrder | public List getArgumentOrder()(Code) | | Returns a list of argument names found in this connector's
default argument map, defining the order in which arguments
should be presented to the user. Since a map is not ordered,
this provides control on how arguments will be presented to
the user.
list of argument names |
getDefaultArguments | public Map getDefaultArguments() throws CoreException(Code) | | Returns a map of default arguments used by this connector.
The keys of the map are names of arguments used by this
connector, and the values are of type
com.sun.jdi.connect.Connector.Argument .
argument map with default values exception: CoreException - if unable to retrieve a default argument map |
getIdentifier | public String getIdentifier()(Code) | | Returns a unique identifier for this kind of connector.
a unique identifier for this kind of connector |
getName | public String getName()(Code) | | Returns the name of this connector.
the name of this connector |
|
|