com.dkfqs.tools.http

Class HTTPConnectionStatistic

java.lang.Object

com.dkfqs.tools.http.HTTPConnectionStatistic

public class HTTPConnectionStatistic
extends java.lang.Object

An overall statistic of the network connections used by a HTTPClient (instance). All methods are thread-safe and can be called at any time.

The statistic contains per Web server '<protocol><host><port>' the following performance data:

• The number of created TCP/IP network connections.
• The number of reused TCP/IP network connections.
• The average, minimum, maximum and latest measured SSL prepare time (at client side).
• The average, minimum, maximum and latest measured TCP connect time.
• The average, minimum, maximum and latest measured SSL Handshake time.

Example - dumpToStdout():

 --- vvv --- HTTPConnectionStatistic --- vvv ---
 https://www.dkfqa.com:443 | Network Connections: total created = 2, total reused = 0 | SSL Prepare Time: average = 696 ms, min = 0 ms, max = 1391 ms, latest = 0 ms | TCP Connect Time: average = 201 ms, min = 189 ms, max = 212 ms, latest = 189 ms | SSL Handshake Time: average = 1036 ms, min = 852 ms, max = 1219 ms, latest = 852 ms
 https://www.google.ch:443 | Network Connections: total created = 1, total reused = 1 | SSL Prepare Time: average = 0 ms, min = 0 ms, max = 0 ms, latest = 0 ms | TCP Connect Time: average = 136 ms, min = 136 ms, max = 136 ms, latest = 136 ms | SSL Handshake Time: average = 179 ms, min = 179 ms, max = 179 ms, latest = 179 ms
 --- ^^^ --- HTTPConnectionStatistic --- ^^^ ---
 

See Also:

HTTPClient.getConnectionStatistic()

Method Summary

Modifier and Type	Method and Description
void	dumpToStdout() Dump the network connection statistic to stdout.
java.util.ArrayList<HTTPConnectionStatisticElement>	getAllStatisticElements(boolean sortByProtocolHostPort) Get all elements of the network connection statistic.
long	getAverageHTTPKeepAliveEfficiency() Get the average HTTP keep alive efficiency, calculated overall Web servers.
long	getAverageSSLHandshakeTime() Get the average SSL handshake time, calculated overall Web servers.
long	getAverageTCPConnectTime() Get the average TCP/IP connect time for opening the network connection to the server, calculated overall Web servers.
long	getNumNewCreatedConnections() Get the total number of new, successfully connected TCP/IP connections, calculated overall Web servers.
long	getNumReusedConnections() Get the total number of successfully reused TCP/IP connections, calculated overall Web servers.
HTTPConnectionStatisticElement	getStatisticElement(java.lang.String protocol, java.lang.String host, int port) Get a particular element of the network connection statistic.

Methods inherited from class java.lang.Object

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

Method Detail

getStatisticElement

public HTTPConnectionStatisticElement getStatisticElement(java.lang.String protocol,
                                                          java.lang.String host,
                                                          int port)

Get a particular element of the network connection statistic. This method is thread-safe.

Parameters:

protocol - the protocol, 'http' or 'https'

host - the host name or IP address

port - the TCP/IP port number

Returns:

the particular element of the network connection statistic, or null if no such element exists

getAllStatisticElements

public java.util.ArrayList<HTTPConnectionStatisticElement> getAllStatisticElements(boolean sortByProtocolHostPort)

Get all elements of the network connection statistic. This method is thread-safe.

Parameters:

sortByProtocolHostPort - if true the sort the elements 1) by protocol, 2) by host, 3) by port

Returns:

An array list of all elements of the network connection statistic

getAverageTCPConnectTime

public long getAverageTCPConnectTime()

Get the average TCP/IP connect time for opening the network connection to the server, calculated overall Web servers. This method is thread-safe.

Returns:

the average TCP/IP connect time in milliseconds, or -1 if no such data is available

getAverageHTTPKeepAliveEfficiency

public long getAverageHTTPKeepAliveEfficiency()

Get the average HTTP keep alive efficiency, calculated overall Web servers. This method is thread-safe.

Returns:

the average HTTP keep alive efficiency in percent, or -1 if no such data is available

getNumNewCreatedConnections

public long getNumNewCreatedConnections()

Get the total number of new, successfully connected TCP/IP connections, calculated overall Web servers.

Returns:

the total number of new, successfully connected TCP/IP connections

getNumReusedConnections

public long getNumReusedConnections()

Get the total number of successfully reused TCP/IP connections, calculated overall Web servers.

Returns:

the total number of successfully reused TCP/IP connections

getAverageSSLHandshakeTime

public long getAverageSSLHandshakeTime()

Get the average SSL handshake time, calculated overall Web servers. This method is thread-safe.

Returns:

the average SSL handshake time in milliseconds, or -1 if no such data is available

dumpToStdout

public void dumpToStdout()

Dump the network connection statistic to stdout. This method is thread-safe.

See Also:

getAllStatisticElements(boolean)