|
Java Debug Interface | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ListeningConnector
A connector which listens for a connection initiated by a target VM.
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface com.sun.jdi.connect.Connector |
---|
Connector.Argument, Connector.BooleanArgument, Connector.IntegerArgument, Connector.SelectedArgument, Connector.StringArgument |
Method Summary | |
---|---|
VirtualMachine |
accept(Map<String,? extends Connector.Argument> arguments)
Waits for a target VM to attach to this connector. |
String |
startListening(Map<String,? extends Connector.Argument> arguments)
Listens for one or more connections initiated by target VMs. |
void |
stopListening(Map<String,? extends Connector.Argument> arguments)
Cancels listening for connections. |
boolean |
supportsMultipleConnections()
Indicates whether this listening connector supports multiple connections for a single argument map. |
Methods inherited from interface com.sun.jdi.connect.Connector |
---|
defaultArguments, description, name, transport |
Method Detail |
---|
boolean supportsMultipleConnections()
startListening(java.util.Map)
may allow
multiple target VM to become connected.
true
if multiple connections are supported;
false
otherwise.String startListening(Map<String,? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException
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.
This method does not return a VirtualMachine
, and, normally,
returns before any target VM initiates
a connection. The connected target is obtained through
accept(java.util.Map
(using the same argument map as is passed to this
method).
If arguments
contains addressing information. and
only one conection will be accepted, the accept
method
can be called immediately without calling this method.
IOException
- when unable to start listening.
Specific exceptions are dependent on the Connector implementation
in use.
IllegalConnectorArgumentsException
- when one of the
connector arguments is invalid.void stopListening(Map<String,? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException
startListening(java.util.Map)
invocation.
IOException
- when unable to stop listening.
Specific exceptions are dependent on the Connector implementation
in use.
IllegalConnectorArgumentsException
- when one of the
connector arguments is invalid.VirtualMachine accept(Map<String,? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException
TransportTimeoutException
- when the Connector encapsulates
a transport that supports a timeout when accepting, a
Connector.Argument
representing a timeout has been set
in the argument map, and a timeout occurs whilst waiting for
the target VM to connect.
IOException
- when unable to accept.
Specific exceptions are dependent on the Connector implementation
in use.
IllegalConnectorArgumentsException
- when one of the
connector arguments is invalid.
|
Java Debug Interface | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |