org.ldaptive.pool

Class BlockingConnectionPool

java.lang.Object

org.ldaptive.pool.AbstractPool<Connection>

org.ldaptive.pool.AbstractConnectionPool

org.ldaptive.pool.BlockingConnectionPool

All Implemented Interfaces:

ConnectionPool

Direct Known Subclasses:

SoftLimitConnectionPool

public class BlockingConnectionPool
extends AbstractConnectionPool

Implements a pool of connections that has a set minimum and maximum size. The pool will not grow beyond the maximum size and when the pool is exhausted, requests for new connections will block. The length of time the pool will block is determined by getBlockWaitTime(). By default the pool will block indefinitely and there is no guarantee that waiting threads will be serviced in the order in which they made their request. This implementation should be used when you need to control the exact number of connections that can be created. See AbstractConnectionPool.

Nested Class Summary

Nested classes/interfaces inherited from class org.ldaptive.pool.AbstractConnectionPool

AbstractConnectionPool.DefaultPooledConnectionProxy

Field Summary

Fields

Modifier and Type	Field and Description
private long	blockWaitTime Time in milliseconds to wait for an available connection.

Fields inherited from class org.ldaptive.pool.AbstractConnectionPool

active, available, checkInLock, checkOutLock, poolLock, poolNotEmpty

Fields inherited from class org.ldaptive.pool.AbstractPool

logger

Constructor Summary

Constructors

Constructor and Description
BlockingConnectionPool() Creates a new blocking pool.
BlockingConnectionPool(DefaultConnectionFactory cf) Creates a new blocking pool.
BlockingConnectionPool(PoolConfig pc, DefaultConnectionFactory cf) Creates a new blocking pool.

Method Summary

Modifier and Type	Method and Description
protected PooledConnectionProxy	blockAvailableConnection() This blocks until a connection can be acquired.
long	getBlockWaitTime() Returns the block wait time.
Connection	getConnection() Returns a connection from the pool.
void	putConnection(Connection c) Returns a connection to the pool.
protected PooledConnectionProxy	retrieveAvailableConnection() Attempts to retrieve a connection from the available queue.
void	setBlockWaitTime(long time) Sets the block wait time.

Methods inherited from class org.ldaptive.pool.AbstractConnectionPool

activateAndValidateConnection, activeCount, availableCount, close, createActiveConnection, createActiveConnection, createAvailableConnection, createAvailableConnection, createConnection, createConnection, createConnectionProxy, finalize, getConnectionFactory, getConnectOnCreate, getFailFastInitialize, getPooledConnectionStatistics, getQueueType, grow, grow, initialize, isInitialized, prune, removeActiveConnection, removeAvailableAndActiveConnection, removeAvailableConnection, retrieveConnectionProxy, setConnectionFactory, setConnectOnCreate, setFailFastInitialize, setQueueType, throwIfNotInitialized, toString, validate, validateAndPassivateConnection

Methods inherited from class org.ldaptive.pool.AbstractPool

activate, getActivator, getName, getPassivator, getPoolConfig, getPruneStrategy, getValidator, passivate, setActivator, setName, setPassivator, setPoolConfig, setPruneStrategy, setValidator, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ldaptive.pool.ConnectionPool

getActivator, getPassivator, getValidator, setActivator, setPassivator, setValidator

Field Detail

blockWaitTime

private long blockWaitTime

Time in milliseconds to wait for an available connection.

Constructor Detail

BlockingConnectionPool

public BlockingConnectionPool()

Creates a new blocking pool.

BlockingConnectionPool

public BlockingConnectionPool(DefaultConnectionFactory cf)

Creates a new blocking pool. The pool config is initialized with the default values.

Parameters:

cf - connection factory

BlockingConnectionPool

public BlockingConnectionPool(PoolConfig pc,
                              DefaultConnectionFactory cf)

Creates a new blocking pool.

Parameters:

pc - pool configuration

cf - connection factory

Method Detail

getBlockWaitTime

public long getBlockWaitTime()

Returns the block wait time. Default time is 0, which will wait indefinitely.

Returns:

time in milliseconds to wait for available connections

setBlockWaitTime

public void setBlockWaitTime(long time)

Sets the block wait time. Default time is 0, which will wait indefinitely.

Parameters:

time - in milliseconds to wait for available connections

getConnection

public Connection getConnection()
                         throws PoolException

Description copied from class: AbstractConnectionPool

Returns a connection from the pool.

Specified by:

getConnection in interface ConnectionPool

Specified by:

getConnection in class AbstractConnectionPool

Returns:

connection

Throws:

PoolException - if this operation fails

BlockingTimeoutException - if this pool is configured with a block time and it occurs

PoolInterruptedException - if this pool is configured with a block time and the current thread is interrupted

retrieveAvailableConnection

protected PooledConnectionProxy retrieveAvailableConnection()

Attempts to retrieve a connection from the available queue.

Returns:

connection from the pool

Throws:

java.util.NoSuchElementException - if the available queue is empty

blockAvailableConnection

protected PooledConnectionProxy blockAvailableConnection()
                                                  throws PoolException

This blocks until a connection can be acquired.

Returns:

connection from the pool

Throws:

PoolException - if this method fails

BlockingTimeoutException - if this pool is configured with a block time and it occurs

PoolInterruptedException - if the current thread is interrupted

putConnection

public void putConnection(Connection c)

Description copied from class: AbstractConnectionPool

Returns a connection to the pool.

Specified by:

putConnection in class AbstractConnectionPool

Parameters:

c - connection