org.aoju.bus.http

Class EventListener

java.lang.Object

org.aoju.bus.http.EventListener

public abstract class EventListener
extends Object

Listener for metrics events. Extend this class to monitor the quantity, size, and duration of your application's HTTP calls.

All start/connect/acquire events will eventually receive a matching end/release event, either successful (non-null parameters), or failed (non-null throwable). The first core parameters of each event pair are used to link the event in case of concurrent or repeated events e.g. dnsStart(call, domainName) -> dnsEnd(call, domainName, inetAddressList).

Nesting is as follows

• call -> (dns -> connect -> secure connect)* -> request events
• call -> (connection acquire/release)*

Request events are ordered: requestHeaders -> requestBody -> responseHeaders -> responseBody

Since connections may be reused, the dns and connect events may not be present for a call, or may be repeated in case of failure retries, even concurrently in case of happy eyeballs type scenarios. A redirect cross entity, or to use https may cause additional connection and request events.

All event methods must execute fast, without external locking, cannot throw exceptions, attempt to mutate the event parameters, or be reentrant back into the client. Any IO - writing to files or network should be done asynchronously.

Since:

JDK 1.8

Version:

3.2.6

Author:

Kimi Liu

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	EventListener.Factory

Field Summary

Fields

Modifier and Type	Field and Description
static EventListener	NONE

Constructor Summary

Constructors

Constructor and Description
EventListener()

Method Summary

Modifier and Type	Method and Description
void	callEnd(Call call)
void	callFailed(Call call, IOException ioe)
void	callStart(Call call)
void	connectEnd(Call call, InetSocketAddress inetSocketAddress, Proxy proxy, Protocol protocol)
void	connectFailed(Call call, InetSocketAddress inetSocketAddress, Proxy proxy, Protocol protocol, IOException ioe)
void	connectionAcquired(Call call, Connection connection)
void	connectionReleased(Call call, Connection connection)
void	connectStart(Call call, InetSocketAddress inetSocketAddress, Proxy proxy)
void	dnsEnd(Call call, String domainName, List<InetAddress> inetAddressList)
void	dnsStart(Call call, String domainName)
void	requestBodyEnd(Call call, long byteCount)
void	requestBodyStart(Call call)
void	requestHeadersEnd(Call call, Request request)
void	requestHeadersStart(Call call)
void	responseBodyEnd(Call call, long byteCount)
void	responseBodyStart(Call call)
void	responseHeadersEnd(Call call, Response response)
void	responseHeadersStart(Call call)
void	secureConnectEnd(Call call, Handshake handshake)
void	secureConnectStart(Call call)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NONE

public static final EventListener NONE

Constructor Detail

EventListener

public EventListener()

Method Detail

callStart

public void callStart(Call call)

dnsStart

public void dnsStart(Call call,
                     String domainName)

dnsEnd

public void dnsEnd(Call call,
                   String domainName,
                   List<InetAddress> inetAddressList)

connectStart

public void connectStart(Call call,
                         InetSocketAddress inetSocketAddress,
                         Proxy proxy)

secureConnectStart

public void secureConnectStart(Call call)

secureConnectEnd

public void secureConnectEnd(Call call,
                             Handshake handshake)

connectEnd

public void connectEnd(Call call,
                       InetSocketAddress inetSocketAddress,
                       Proxy proxy,
                       Protocol protocol)

connectFailed

public void connectFailed(Call call,
                          InetSocketAddress inetSocketAddress,
                          Proxy proxy,
                          Protocol protocol,
                          IOException ioe)

connectionAcquired

public void connectionAcquired(Call call,
                               Connection connection)

connectionReleased

public void connectionReleased(Call call,
                               Connection connection)

requestHeadersStart

public void requestHeadersStart(Call call)

requestHeadersEnd

public void requestHeadersEnd(Call call,
                              Request request)

requestBodyStart

public void requestBodyStart(Call call)

requestBodyEnd

public void requestBodyEnd(Call call,
                           long byteCount)

responseHeadersStart

public void responseHeadersStart(Call call)

responseHeadersEnd

public void responseHeadersEnd(Call call,
                               Response response)

responseBodyStart

public void responseBodyStart(Call call)

responseBodyEnd

public void responseBodyEnd(Call call,
                            long byteCount)

callEnd

public void callEnd(Call call)

callFailed

public void callFailed(Call call,
                       IOException ioe)