org.eclipse.jetty.client

Class ValidatingConnectionPool

java.lang.Object

org.eclipse.jetty.client.AbstractConnectionPool

org.eclipse.jetty.client.DuplexConnectionPool

org.eclipse.jetty.client.ValidatingConnectionPool

All Implemented Interfaces:

Closeable, AutoCloseable, ConnectionPool, Dumpable, Sweeper.Sweepable

public class ValidatingConnectionPool
extends DuplexConnectionPool

A connection pool that validates connections before making them available for use.

Connections that have just been opened are not validated. Connections that are released will be validated.

Validation by reading from the EndPoint is not reliable, since the TCP FIN may arrive just after the validation read.

This class validates connections by putting them in a "quarantine" for a configurable timeout, where they cannot be used to send requests. When the timeout expires, the quarantined connection is made idle and therefore available to send requests.

The existing HttpClient mechanism to detect server closes will trigger and close quarantined connections, before they are made idle (and reusable) again.

There still is a small chance that the timeout expires, the connection is made idle and available again, it is used to send a request exactly when the server decides to close. This case is however unavoidable and may be mitigated by tuning the idle timeout of the servers to be larger than that of the client.

Constructor Summary

Constructors

Constructor and Description
ValidatingConnectionPool(Destination destination, int maxConnections, Callback requester, Scheduler scheduler, long timeout)

Method Summary

Modifier and Type	Method and Description
void	dump(Appendable out, String indent)
int	getValidatingConnectionCount()
boolean	release(Connection connection)
boolean	remove(Connection connection)
String	toString()

Methods inherited from class org.eclipse.jetty.client.DuplexConnectionPool

activate, close, deactivate, getActiveConnectionCount, getActiveConnections, getIdleConnectionCount, getIdleConnections, isActive, lock, onCreated, remove, sweep, unlock

Methods inherited from class org.eclipse.jetty.client.AbstractConnectionPool

acquire, acquired, active, close, dump, getConnectionCount, getMaxConnectionCount, idle, isClosed, isEmpty, proceed, released, removed

Methods inherited from class java.lang.Object

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

Constructor Detail

ValidatingConnectionPool

public ValidatingConnectionPool(Destination destination,
                                int maxConnections,
                                Callback requester,
                                Scheduler scheduler,
                                long timeout)

Method Detail

getValidatingConnectionCount

@ManagedAttribute(value="The number of validating connections",
                  readonly=true)
public int getValidatingConnectionCount()

release

public boolean release(Connection connection)

Specified by:

release in interface ConnectionPool

Overrides:

release in class DuplexConnectionPool

remove

public boolean remove(Connection connection)

Specified by:

remove in interface ConnectionPool

Overrides:

remove in class DuplexConnectionPool

dump

public void dump(Appendable out,
                 String indent)
          throws IOException

Specified by:

dump in interface Dumpable

Overrides:

dump in class DuplexConnectionPool

Throws:

IOException

toString

public String toString()

Overrides:

toString in class DuplexConnectionPool