| Listens for one or more connections initiated by target VMs.
The connector uses the given argument map
in determining the address at which to listen or else it generates
an appropriate listen address. In either case, an address string
is returned from this method which can be used in starting target VMs
to identify this connector. The format of the address string
is connector, transport, and, possibly, platform dependent.
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
ListeningConnector.accept (using the same argument map as is passed to this
method).
If arguments contains addressing information. and
only one conection will be accepted, the
ListeningConnector.accept accept method
can be called immediately without calling this method.
the address at which the connector is listeningfor a connection.
throws:
java.io.IOException - when unable to start listening. Specific exceptions are dependent on the Connector implementationin use.
throws:
IllegalConnectorArgumentsException - when one of the connector arguments is invalid. |