@Contract(threading=SAFE_CONDITIONAL) public final class MultihomeConnectionInitiator extends Object implements ConnectionInitiator
ConnectionInitiator.| Constructor and Description |
|---|
MultihomeConnectionInitiator(ConnectionInitiator connectionInitiator,
DnsResolver dnsResolver) |
| Modifier and Type | Method and Description |
|---|---|
Future<IOSession> |
connect(NamedEndpoint remoteEndpoint,
SocketAddress remoteAddress,
SocketAddress localAddress,
Timeout connectTimeout,
Object attachment,
FutureCallback<IOSession> callback)
Requests a connection to a remote host.
|
Future<IOSession> |
connect(NamedEndpoint remoteEndpoint,
SocketAddress localAddress,
Timeout connectTimeout,
Object attachment,
FutureCallback<IOSession> callback) |
public MultihomeConnectionInitiator(ConnectionInitiator connectionInitiator, DnsResolver dnsResolver)
public Future<IOSession> connect(NamedEndpoint remoteEndpoint, SocketAddress remoteAddress, SocketAddress localAddress, Timeout connectTimeout, Object attachment, FutureCallback<IOSession> callback)
ConnectionInitiator
Opening a connection to a remote host usually tends to be a time
consuming process and may take a while to complete. One can monitor and
control the process of session initialization by means of the
Future interface.
There are several parameters one can use to exert a greater control over the process of session initialization:
A non-null local socket address parameter can be used to bind the socket to a specific local address.
An attachment object can added to the new session's context upon initialization. This object can be used to pass an initial processing state to the protocol handler.
It is often desirable to be able to react to the completion of a session
request asynchronously without having to wait for it, blocking the
current thread of execution. One can optionally provide an implementation
FutureCallback instance to get notified of events related
to session requests, such as request completion, cancellation, failure or
timeout.
connect in interface ConnectionInitiatorremoteEndpoint - name of the remote host.remoteAddress - remote socket address.localAddress - local socket address. Can be null,
in which can the default local address and a random port will be used.connectTimeout - connect timeout.attachment - the attachment object. Can be null.callback - interface. Can be null.public Future<IOSession> connect(NamedEndpoint remoteEndpoint, SocketAddress localAddress, Timeout connectTimeout, Object attachment, FutureCallback<IOSession> callback)