org.asynchttpclient.handler

Interface AsyncHandlerExtensions

All Known Implementing Classes:

ExtendedAsyncHandler

public interface AsyncHandlerExtensions

This interface hosts new low level callback methods on AsyncHandler.

Method Summary

Modifier and Type	Method and Description
void	onConnectionOffer(io.netty.channel.Channel connection) Notify the callback when trying to offer a connection to the pool.
void	onConnectionPool() Notify the callback when trying to fetch a connection from the pool.
void	onConnectionPooled(io.netty.channel.Channel connection) Notify the callback when a new connection was successfully fetched from the pool.
void	onHostnameResolutionAttempt(String name) Notify the callback before hostname resolution
void	onHostnameResolutionFailure(String name, Throwable cause) Notify the callback after hostname resolution failed.
void	onHostnameResolutionSuccess(String name, List<InetSocketAddress> addresses) Notify the callback after hostname resolution was successful.
void	onRequestSend(NettyRequest request) Notify the callback when a request is being written on the channel.
void	onRetry() Notify the callback every time a request is being retried.
void	onTcpConnect(InetSocketAddress remoteAddress) Notify the callback when trying to open a new connection.
void	onTcpConnectFailure(InetSocketAddress remoteAddress, Throwable cause) Notify the callback after a failed connect.
void	onTcpConnectSuccess(InetSocketAddress remoteAddress, io.netty.channel.Channel connection) Notify the callback after a successful connect
void	onTlsHandshake() Notify the callback before TLS handshake
void	onTlsHandshakeFailure(Throwable cause) Notify the callback after the TLS failed
void	onTlsHandshakeSuccess() Notify the callback after the TLS was successful

Method Detail

onHostnameResolutionAttempt

void onHostnameResolutionAttempt(String name)

Notify the callback before hostname resolution

Parameters:

name - the name to be resolved

onHostnameResolutionSuccess

void onHostnameResolutionSuccess(String name,
                                 List<InetSocketAddress> addresses)

Notify the callback after hostname resolution was successful.

Parameters:

name - the name to be resolved

addresses - the resolved addresses

onHostnameResolutionFailure

void onHostnameResolutionFailure(String name,
                                 Throwable cause)

Notify the callback after hostname resolution failed.

Parameters:

name - the name to be resolved

cause - the failure cause

onTcpConnect

void onTcpConnect(InetSocketAddress remoteAddress)

Notify the callback when trying to open a new connection. Might be called several times if the name was resolved to multiple addresses and we failed to connect to the first(s) one(s).

Parameters:

remoteAddress - the address we try to connect to

onTcpConnectSuccess

void onTcpConnectSuccess(InetSocketAddress remoteAddress,
                         io.netty.channel.Channel connection)

Notify the callback after a successful connect

Parameters:

remoteAddress - the address we try to connect to

connection - the connection

onTcpConnectFailure

void onTcpConnectFailure(InetSocketAddress remoteAddress,
                         Throwable cause)

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

Parameters:

remoteAddress - the address we try to connect to

cause - the cause of the failure

onTlsHandshake

void onTlsHandshake()

Notify the callback before TLS handshake

onTlsHandshakeSuccess

void onTlsHandshakeSuccess()

Notify the callback after the TLS was successful

onTlsHandshakeFailure

void onTlsHandshakeFailure(Throwable cause)

Notify the callback after the TLS failed

Parameters:

cause - the cause of the failure

onConnectionPool

void onConnectionPool()

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

onConnectionPooled

void onConnectionPooled(io.netty.channel.Channel connection)

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

Parameters:

connection - the connection

onConnectionOffer

void onConnectionOffer(io.netty.channel.Channel connection)

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

Parameters:

connection - the connection

onRequestSend

void onRequestSend(NettyRequest request)

Notify the callback when a request is being written on the channel. 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.