org.asynchttpclient.handler

Interface AsyncHandlerExtensions

public interface AsyncHandlerExtensions

This interface hosts new low level callback methods on AsyncHandler. For now, those methods are in a dedicated interface in order not to break the existing API, but could be merged into one of the existing ones in AHC 2.

Method Summary

Modifier and Type	Method and Description
void	onConnectionFailure(InetAddress address) Notify the callback after a failed connect.
void	onConnectionOffer(Object connection) Notify the callback when trying to offer a connection to the pool.
void	onConnectionOpen() Notify the callback when trying to open a new connection.
void	onConnectionPool() Notify the callback when trying to fetch a connection from the pool.
void	onConnectionPooled(Object connection) Notify the callback when a new connection was successfully fetched from the pool.
void	onConnectionSuccess(Object connection, InetAddress address) Notify the callback after a successful connect
void	onDnsResolved(NameResolution[] addresses) Notify the callback after DNS resolution has completed.
void	onRequestSend(Object request) Notify the callback when a request is being written on the wire.
void	onRetry() Notify the callback every time a request is being retried.
void	onSslHandshakeCompleted() Notify the callback when the SSL handshake performed to establish an HTTPS connection has been completed.

Method Detail

onConnectionOpen

void onConnectionOpen()

Notify the callback when trying to open a new connection.

onDnsResolved

void onDnsResolved(NameResolution[] addresses)

Notify the callback after DNS resolution has completed.

Parameters:

addresses - the resolved addresses

onConnectionSuccess

void onConnectionSuccess(Object connection,
                         InetAddress address)

Notify the callback after a successful connect

Parameters:

connection - the connection

address - the connected addresses

onConnectionFailure

void onConnectionFailure(InetAddress address)

Notify the callback after a failed connect. Might be called several times, or be followed by onConnectionSuccess when the name was resolved to multiple addresses.

Parameters:

address - the tentative addresses

onConnectionPool

void onConnectionPool()

Notify the callback when trying to fetch a connection from the pool.

onConnectionPooled

void onConnectionPooled(Object connection)

Notify the callback when a new connection was successfully fetched from the pool.

Parameters:

connection - the connection

onConnectionOffer

void onConnectionOffer(Object connection)

Notify the callback when trying to offer a connection to the pool.

Parameters:

connection - the connection

onRequestSend

void onRequestSend(Object request)

Notify the callback when a request is being written on the wire. If the original request causes multiple requests to be sent, for example, because of authorization or retry, it will be notified multiple times.

Parameters:

request - the real request object as passed to the provider

onRetry

void onRetry()

Notify the callback every time a request is being retried.

onSslHandshakeCompleted

void onSslHandshakeCompleted()

Notify the callback when the SSL handshake performed to establish an HTTPS connection has been completed.