org.eclipse.jetty.client

Interface ConnectionPool

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable

All Known Implementing Classes:

AbstractConnectionPool, DuplexConnectionPool, LeakTrackingConnectionPool, MultiplexConnectionPool, RoundRobinConnectionPool, ValidatingConnectionPool

public interface ConnectionPool
extends java.io.Closeable

Client-side connection pool abstraction.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ConnectionPool.Factory Factory for ConnectionPool instances.
static interface	ConnectionPool.Multiplexable Marks a connection pool as supporting multiplexed connections.

Method Summary

Modifier and Type	Method and Description
Connection	acquire() Returns an idle connection, if available, or schedules the opening of a new connection and returns null.
void	close() Closes this ConnectionPool.
boolean	isActive(Connection connection)
boolean	isClosed()
boolean	isEmpty()
boolean	release(Connection connection) Returns the given connection, previously obtained via acquire(), back to this ConnectionPool.
boolean	remove(Connection connection) Removes the given connection from this ConnectionPool.

Method Detail

isActive

boolean isActive(Connection connection)

Parameters:

connection - the connection to test

Returns:

whether the given connection is currently in use

isEmpty

boolean isEmpty()

Returns:

whether this ConnectionPool has no open connections

isClosed

boolean isClosed()

Returns:

whether this ConnectionPool has been closed

See Also:

close()

acquire

Connection acquire()

Returns an idle connection, if available, or schedules the opening of a new connection and returns null.

Returns:

an available connection, or null

release

boolean release(Connection connection)

Returns the given connection, previously obtained via acquire(), back to this ConnectionPool.

Parameters:

connection - the connection to release

Returns:

true if the connection has been released, false if the connection should be closed

remove

boolean remove(Connection connection)

Removes the given connection from this ConnectionPool.

Parameters:

connection - the connection to remove

Returns:

true if the connection was removed from this ConnectionPool

close

void close()

Closes this ConnectionPool.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

See Also:

isClosed()