Module org.eclipse.jetty.client

Package org.eclipse.jetty.client

Class AbstractConnectionPool

java.lang.Object

org.eclipse.jetty.client.AbstractConnectionPool

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, ConnectionPool, Dumpable

Direct Known Subclasses:

DuplexConnectionPool, MultiplexConnectionPool, RoundRobinConnectionPool

@ManagedObject
public abstract class AbstractConnectionPool
extends java.lang.Object
implements ConnectionPool, Dumpable

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.client.ConnectionPool

ConnectionPool.Factory, ConnectionPool.Multiplexable

Field Summary

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

KEY

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractConnectionPool(HttpDestination destination, int maxConnections, Callback requester)

Method Summary

Modifier and Type	Method	Description
boolean	accept(Connection connection)	Accepts the given connection to be managed by this ConnectionPool.
Connection	acquire(boolean create)	Returns an idle connection, if available; if an idle connection is not available, and the given create parameter is true, then schedules the opening of a new connection, if possible within the configuration of this connection pool (for example, if it does not exceed the max connection count); otherwise returns null.
protected void	acquired(Connection connection)
protected abstract Connection	activate()
protected Connection	active(Connection connection)
void	close()
protected void	close(java.util.Collection<Connection> connections)
java.lang.String	dump()
int	getConnectionCount()
protected HttpDestination	getHttpDestination()
int	getMaxConnectionCount()
int	getPendingConnectionCount()
protected boolean	idle(Connection connection, boolean close)
boolean	isClosed()
boolean	isEmpty()
protected abstract void	onCreated(Connection connection)
protected void	proceed()
protected void	released(Connection connection)
protected void	removed(Connection connection)
protected void	tryCreate(int maxPending)	Schedules the opening of a new connection.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.client.ConnectionPool

isActive, release, remove

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dump, dumpSelf

Constructor Detail

AbstractConnectionPool

protected AbstractConnectionPool(HttpDestination destination,
                                 int maxConnections,
                                 Callback requester)

Method Detail

getHttpDestination

protected HttpDestination getHttpDestination()

getMaxConnectionCount

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

getConnectionCount

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

getPendingConnectionCount

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

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface ConnectionPool

Returns:

whether this ConnectionPool has no open connections

isClosed

public boolean isClosed()

Specified by:

isClosed in interface ConnectionPool

Returns:

whether this ConnectionPool has been closed

See Also:

ConnectionPool.close()

acquire

public Connection acquire(boolean create)

Description copied from interface: ConnectionPool

Returns an idle connection, if available; if an idle connection is not available, and the given create parameter is true, then schedules the opening of a new connection, if possible within the configuration of this connection pool (for example, if it does not exceed the max connection count); otherwise returns null.

Specified by:

acquire in interface ConnectionPool

Parameters:

create - whether to schedule the opening of a connection if no idle connections are available

Returns:

an idle connection or null if no idle connections are available

tryCreate

protected void tryCreate(int maxPending)

Schedules the opening of a new connection.

Whether a new connection is scheduled for opening is determined by the maxPending parameter: if maxPending is greater than the current number of connections scheduled for opening, then this method returns without scheduling the opening of a new connection; if maxPending is negative, a new connection is always scheduled for opening.

Parameters:

maxPending - the max desired number of connections scheduled for opening, or a negative number to always trigger the opening of a new connection

accept

public boolean accept(Connection connection)

Description copied from interface: ConnectionPool

Accepts the given connection to be managed by this ConnectionPool.

Specified by:

accept in interface ConnectionPool

Parameters:

connection - the connection to accept

Returns:

whether the connection has been accepted

onCreated

protected abstract void onCreated(Connection connection)

proceed

protected void proceed()

activate

protected abstract Connection activate()

active

protected Connection active(Connection connection)

acquired

protected void acquired(Connection connection)

idle

protected boolean idle(Connection connection,
                       boolean close)

released

protected void released(Connection connection)

removed

protected void removed(Connection connection)

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface ConnectionPool

close

protected void close(java.util.Collection<Connection> connections)

dump

public java.lang.String dump()

Specified by:

dump in interface Dumpable