org.apache.hc.client5.http.nio

Interface AsyncClientConnectionOperator

All Known Implementing Classes:

DefaultAsyncClientConnectionOperator

@Contract(threading=STATELESS)
 @Internal
public interface AsyncClientConnectionOperator

Connection operator that performs connection connect and upgrade operations.

Since:

5.0

Method Summary

Modifier and Type	Method and Description
default Future<ManagedAsyncClientConnection>	connect(org.apache.hc.core5.reactor.ConnectionInitiator connectionInitiator, org.apache.hc.core5.http.HttpHost endpointHost, org.apache.hc.core5.net.NamedEndpoint endpointName, SocketAddress localAddress, org.apache.hc.core5.util.Timeout connectTimeout, Object attachment, org.apache.hc.core5.http.protocol.HttpContext context, org.apache.hc.core5.concurrent.FutureCallback<ManagedAsyncClientConnection> callback) Initiates operation to create a connection to the remote endpoint using the provided ConnectionInitiator.
Future<ManagedAsyncClientConnection>	connect(org.apache.hc.core5.reactor.ConnectionInitiator connectionInitiator, org.apache.hc.core5.http.HttpHost host, SocketAddress localAddress, org.apache.hc.core5.util.Timeout connectTimeout, Object attachment, org.apache.hc.core5.concurrent.FutureCallback<ManagedAsyncClientConnection> callback) Initiates operation to create a connection to the remote endpoint using the provided ConnectionInitiator.
default void	upgrade(ManagedAsyncClientConnection conn, org.apache.hc.core5.http.HttpHost endpointHost, org.apache.hc.core5.net.NamedEndpoint endpointName, Object attachment, org.apache.hc.core5.http.protocol.HttpContext context, org.apache.hc.core5.concurrent.FutureCallback<ManagedAsyncClientConnection> callback) Upgrades transport security of the given managed connection by using the TLS security protocol.
void	upgrade(ManagedAsyncClientConnection conn, org.apache.hc.core5.http.HttpHost host, Object attachment) Upgrades transport security of the given managed connection by using the TLS security protocol.

Method Detail

connect

Future<ManagedAsyncClientConnection> connect(org.apache.hc.core5.reactor.ConnectionInitiator connectionInitiator,
                                             org.apache.hc.core5.http.HttpHost host,
                                             SocketAddress localAddress,
                                             org.apache.hc.core5.util.Timeout connectTimeout,
                                             Object attachment,
                                             org.apache.hc.core5.concurrent.FutureCallback<ManagedAsyncClientConnection> callback)

Initiates operation to create a connection to the remote endpoint using the provided ConnectionInitiator.

Parameters:

connectionInitiator - the connection initiator.

host - the address of the opposite endpoint.

localAddress - the address of the local endpoint.

connectTimeout - the timeout of the connect operation.

attachment - the attachment, which can be any object representing custom parameter of the operation.

callback - the future result callback.

connect

default Future<ManagedAsyncClientConnection> connect(org.apache.hc.core5.reactor.ConnectionInitiator connectionInitiator,
                                                     org.apache.hc.core5.http.HttpHost endpointHost,
                                                     org.apache.hc.core5.net.NamedEndpoint endpointName,
                                                     SocketAddress localAddress,
                                                     org.apache.hc.core5.util.Timeout connectTimeout,
                                                     Object attachment,
                                                     org.apache.hc.core5.http.protocol.HttpContext context,
                                                     org.apache.hc.core5.concurrent.FutureCallback<ManagedAsyncClientConnection> callback)

Initiates operation to create a connection to the remote endpoint using the provided ConnectionInitiator.

Parameters:

connectionInitiator - the connection initiator.

endpointHost - the address of the remote endpoint.

endpointName - the name of the remote endpoint, if different from the endpoint host name, null otherwise. Usually taken from the request URU authority.

localAddress - the address of the local endpoint.

connectTimeout - the timeout of the connect operation.

attachment - the attachment, which can be any object representing custom parameter of the operation.

context - the execution context.

callback - the future result callback.

Since:

5.4

upgrade

void upgrade(ManagedAsyncClientConnection conn,
             org.apache.hc.core5.http.HttpHost host,
             Object attachment)

Upgrades transport security of the given managed connection by using the TLS security protocol.

Parameters:

conn - the managed connection.

host - the address of the opposite endpoint with TLS security.

attachment - the attachment, which can be any object representing custom parameter of the operation.

upgrade

default void upgrade(ManagedAsyncClientConnection conn,
                     org.apache.hc.core5.http.HttpHost endpointHost,
                     org.apache.hc.core5.net.NamedEndpoint endpointName,
                     Object attachment,
                     org.apache.hc.core5.http.protocol.HttpContext context,
                     org.apache.hc.core5.concurrent.FutureCallback<ManagedAsyncClientConnection> callback)

Upgrades transport security of the given managed connection by using the TLS security protocol.

Parameters:

conn - the managed connection.

endpointHost - the address of the remote endpoint.

endpointName - the name of the remote endpoint, if different from the endpoint host name, null otherwise. Usually taken from the request URU authority.

attachment - the attachment, which can be any object representing custom parameter of the operation.

context - the execution context.

callback - the future result callback.

Since:

5.4