org.apache.directory.ldap.client.api

Class LdapConnectionPool

java.lang.Object

org.apache.commons.pool.BaseObjectPool<T>

org.apache.commons.pool.impl.GenericObjectPool<LdapConnection>

org.apache.directory.ldap.client.api.LdapConnectionPool

All Implemented Interfaces:

org.apache.commons.pool.ObjectPool<LdapConnection>

public class LdapConnectionPool
extends org.apache.commons.pool.impl.GenericObjectPool<LdapConnection>

A pool implementation for LdapConnection objects. This class is just a wrapper around the commons GenericObjectPool, and has a more meaningful name to represent the pool type.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.commons.pool.impl.GenericObjectPool

org.apache.commons.pool.impl.GenericObjectPool.Config

Field Summary

Fields

Modifier and Type	Field and Description
private org.apache.commons.pool.PoolableObjectFactory<LdapConnection>	factory
private static org.slf4j.Logger	LOG

Fields inherited from class org.apache.commons.pool.impl.GenericObjectPool

DEFAULT_LIFO, DEFAULT_MAX_ACTIVE, DEFAULT_MAX_IDLE, DEFAULT_MAX_WAIT, DEFAULT_MIN_EVICTABLE_IDLE_TIME_MILLIS, DEFAULT_MIN_IDLE, DEFAULT_NUM_TESTS_PER_EVICTION_RUN, DEFAULT_SOFT_MIN_EVICTABLE_IDLE_TIME_MILLIS, DEFAULT_TEST_ON_BORROW, DEFAULT_TEST_ON_RETURN, DEFAULT_TEST_WHILE_IDLE, DEFAULT_TIME_BETWEEN_EVICTION_RUNS_MILLIS, DEFAULT_WHEN_EXHAUSTED_ACTION, WHEN_EXHAUSTED_BLOCK, WHEN_EXHAUSTED_FAIL, WHEN_EXHAUSTED_GROW

Constructor Summary

Constructors

Constructor and Description
LdapConnectionPool(LdapConnectionConfig connectionConfig, LdapApiService apiService, long timeout) Instantiates a new LDAP connection pool.
LdapConnectionPool(LdapConnectionConfig connectionConfig, LdapApiService apiService, long timeout, org.apache.commons.pool.impl.GenericObjectPool.Config poolConfig) Instantiates a new LDAP connection pool.
LdapConnectionPool(org.apache.commons.pool.PoolableObjectFactory<LdapConnection> factory) Instantiates a new LDAP connection pool.
LdapConnectionPool(org.apache.commons.pool.PoolableObjectFactory<LdapConnection> factory, org.apache.commons.pool.impl.GenericObjectPool.Config poolConfig) Instantiates a new LDAP connection pool.

Method Summary

Modifier and Type	Method and Description
LdapConnection	getConnection() Gives a LdapConnection fetched from the pool.
LdapApiService	getLdapApiService() Returns the LdapApiService instance used by this connection pool.
private static ValidatingPoolableLdapConnectionFactory	newPoolableConnectionFactory(LdapConnectionConfig connectionConfig, LdapApiService apiService, long timeout)
void	releaseConnection(LdapConnection connection) Places the given LdapConnection back in the pool.

Methods inherited from class org.apache.commons.pool.impl.GenericObjectPool

addObject, borrowObject, clear, close, evict, getLifo, getMaxActive, getMaxIdle, getMaxWait, getMinEvictableIdleTimeMillis, getMinIdle, getNumActive, getNumIdle, getNumTestsPerEvictionRun, getSoftMinEvictableIdleTimeMillis, getTestOnBorrow, getTestOnReturn, getTestWhileIdle, getTimeBetweenEvictionRunsMillis, getWhenExhaustedAction, invalidateObject, returnObject, setConfig, setFactory, setLifo, setMaxActive, setMaxIdle, setMaxWait, setMinEvictableIdleTimeMillis, setMinIdle, setNumTestsPerEvictionRun, setSoftMinEvictableIdleTimeMillis, setTestOnBorrow, setTestOnReturn, setTestWhileIdle, setTimeBetweenEvictionRunsMillis, setWhenExhaustedAction, startEvictor

Methods inherited from class org.apache.commons.pool.BaseObjectPool

assertOpen, isClosed

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.slf4j.Logger LOG

factory

private org.apache.commons.pool.PoolableObjectFactory<LdapConnection> factory

Constructor Detail

LdapConnectionPool

public LdapConnectionPool(LdapConnectionConfig connectionConfig,
                          LdapApiService apiService,
                          long timeout)

Instantiates a new LDAP connection pool.

Parameters:

connectionConfig - The connection configuration

apiService - The api service (codec)

timeout - The connection timeout in millis

LdapConnectionPool

public LdapConnectionPool(LdapConnectionConfig connectionConfig,
                          LdapApiService apiService,
                          long timeout,
                          org.apache.commons.pool.impl.GenericObjectPool.Config poolConfig)

Instantiates a new LDAP connection pool.

Parameters:

connectionConfig - The connection configuration

apiService - The api service (codec)

timeout - The connection timeout in millis

poolConfig - The pool configuration

LdapConnectionPool

public LdapConnectionPool(org.apache.commons.pool.PoolableObjectFactory<LdapConnection> factory)

Instantiates a new LDAP connection pool.

Parameters:

factory - The LDAP connection factory

LdapConnectionPool

public LdapConnectionPool(org.apache.commons.pool.PoolableObjectFactory<LdapConnection> factory,
                          org.apache.commons.pool.impl.GenericObjectPool.Config poolConfig)

Instantiates a new LDAP connection pool.

Parameters:

factory - The LDAP connection factory

poolConfig - The pool configuration

Method Detail

getLdapApiService

public LdapApiService getLdapApiService()

Returns the LdapApiService instance used by this connection pool.

Returns:

The LdapApiService instance used by this connection pool.

getConnection

public LdapConnection getConnection()
                             throws LdapException

Gives a LdapConnection fetched from the pool.

Returns:

an LdapConnection object from pool

Throws:

java.lang.Exception - if an error occurs while obtaining a connection from the factory

LdapException

newPoolableConnectionFactory

private static ValidatingPoolableLdapConnectionFactory newPoolableConnectionFactory(LdapConnectionConfig connectionConfig,
                                                                                    LdapApiService apiService,
                                                                                    long timeout)

releaseConnection

public void releaseConnection(LdapConnection connection)
                       throws LdapException

Places the given LdapConnection back in the pool.

Parameters:

connection - the LdapConnection to be released

Throws:

java.lang.Exception - if an error occurs while releasing the connection

LdapException