Apache commons pool 1.5.4

Object pooling API.

The org.apache.commons.pool package defines a simple interface for a pool of object instances, and a handful of base classes that may be useful when creating pool implementations.

The pool package itself doesn't define a specific object pooling implementation, but rather a contract that implementations may support in order to be fully interchangeable.

The pool package separates the way in which instances are pooled from the way in which they are created, resulting in a pair of interfaces:

{@link org.apache.commons.pool.ObjectPool ObjectPool}

defines a simple object pooling interface, with methods for borrowing instances from and returning them to the pool.

{@link org.apache.commons.pool.PoolableObjectFactory PoolableObjectFactory}

defines lifecycle methods for object instances contained within a pool. By associating a factory with a pool, the pool can create new object instances as needed.

{@link org.apache.commons.pool.ObjectPoolFactory ObjectPoolFactory} defines a simple factory for ObjectPools, which may be useful for some applications.

The pool package also provides a keyed pool interface, which pools instances of multiple types, accessed according to an arbitrary key. See {@link org.apache.commons.pool.KeyedObjectPool KeyedObjectPool}, {@link org.apache.commons.pool.KeyedPoolableObjectFactory KeyedPoolableObjectFactory}, and {@link org.apache.commons.pool.KeyedObjectPoolFactory KeyedObjectPoolFactory}.

Object pooling API implementations.

{@link org.apache.commons.pool.impl.StackObjectPool StackObjectPool} ({@link org.apache.commons.pool.impl.StackKeyedObjectPool StackKeyedObjectPool}) provides a simple, {@link java.util.Stack Stack}-based implementation of {@link org.apache.commons.pool.ObjectPool ObjectPool} ({@link org.apache.commons.pool.KeyedObjectPool KeyedObjectPool}). {@link org.apache.commons.pool.impl.StackObjectPoolFactory StackObjectPoolFactory} ({@link org.apache.commons.pool.impl.StackKeyedObjectPoolFactory StackKeyedObjectPoolFactory}) provides an implementation of the {@link org.apache.commons.pool.ObjectPoolFactory ObjectPoolFactory} ({@link org.apache.commons.pool.KeyedObjectPoolFactory KeyedObjectPoolFactory}) factory interface for this class.

{@link org.apache.commons.pool.impl.GenericObjectPool GenericObjectPool} ({@link org.apache.commons.pool.impl.GenericKeyedObjectPool GenericKeyedObjectPool}) provides a more robust (but also more complicated) implementation of {@link org.apache.commons.pool.ObjectPool ObjectPool} ({@link org.apache.commons.pool.KeyedObjectPool KeyedObjectPool}). {@link org.apache.commons.pool.impl.GenericObjectPoolFactory GenericObjectPoolFactory} ({@link org.apache.commons.pool.impl.GenericKeyedObjectPoolFactory GenericKeyedObjectPoolFactory}) provides an implementation of the {@link org.apache.commons.pool.ObjectPoolFactory ObjectPoolFactory} ({@link org.apache.commons.pool.KeyedObjectPoolFactory KeyedObjectPoolFactory}) factory interface for this class.

See also the {@link org.apache.commons.pool} package.