Top Description Methods
org.apache.hc.core5.reactor

public Interface ConnectionInitiator

Known Direct Implementers
org.apache.hc.core5.reactor.SingleCoreIOReactor, org.apache.hc.core5.http.impl.bootstrap.AbstractConnectionInitiatorBase, org.apache.hc.core5.reactor.AbstractIOReactorBase
Imports
java.net.SocketAddress, java.util.concurrent.Future, org.apache.hc.core5.concurrent.FutureCallback, org.apache.hc.core5.net.NamedEndpoint, org.apache.hc.core5.util.Timeout

Non-blocking connection initiator.
Since
5.0

Method Summary

Modifier and TypeMethod and Description
public Future<IOSession>

Returns:

session request object.
connect
(NamedEndpoint
name of the remote host.
remoteEndpoint
,
SocketAddress
remote socket address.
remoteAddress
,
SocketAddress
local socket address. Can be null, in which can the default local address and a random port will be used.
localAddress
,
Timeout
connect timeout.
timeout
,
Object
the attachment object. Can be null.
attachment
,
FutureCallback<IOSession>
interface. Can be null.
callback
)

Requests a connection to a remote host.

Method Detail

connectback to summary
public Future<IOSession> connect(NamedEndpoint remoteEndpoint, SocketAddress remoteAddress, SocketAddress localAddress, Timeout timeout, Object attachment, FutureCallback<IOSession> callback)

Requests a connection to a remote host.

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.

Parameters
remoteEndpoint:NamedEndpoint

name of the remote host.

remoteAddress:SocketAddress

remote socket address.

localAddress:SocketAddress

local socket address. Can be null, in which can the default local address and a random port will be used.

timeout:Timeout

connect timeout.

attachment:Object

the attachment object. Can be null.

callback:FutureCallback<IOSession>

interface. Can be null.

Returns:Future<IOSession>

session request object.