オブジェクトをプーリングするためのAPIです。 {@primary Object pooling API.}

パッケージはシンプルなオブジェクトのプーリングを行うためのインターフェイスと 新たなプール実装を作成する際に有用と思われるいくつかの基底クラスを定義します。 {@primary 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.}

pool パッケージ自身では、プール処理の実装の入替えを妨げないように 明確なオブジェクトプーリングの実装を定義しません。 {@primary 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. }

pool パッケージはインスタンスをプールする手段と、プールされるインスタンスを生成する手段を分離するため、 結果として以下のペアとなるインターフェイスを持ちます: {@primary 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}
プール内からインスタンスを借りて返すシンプルなオブジェクトプーリングのためのインターフェイスを定義します。 {@primary 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}
プール内に保持されるオブジェクトのインスタンスのライフサイクルに関するメソッドを定義します。 プールとファクトリが連携することにより、プールは必要なインスタンスを生成できるようになります。 {@primary 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} はいくつかのアプリケーションで有用なシンプルな ObjectPool のファクトリを定義します。 {@primary {@link org.apache.commons.pool.ObjectPoolFactory ObjectPoolFactory} defines a simple factory for ObjectPools, which may be useful for some applications.}

また、pool パッケージは複数の型を任意のキーと関連付けてプールするインターフェイスも提供します。 詳細な内容に関しては {@link org.apache.commons.pool.KeyedObjectPool KeyedObjectPool}、 {@link org.apache.commons.pool.KeyedPoolableObjectFactory KeyedPoolableObjectFactory}、 {@link org.apache.commons.pool.KeyedObjectPoolFactory KeyedObjectPoolFactory} を参照してください。 {@primary 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}.}

@translator 日置 聡 @status firstdraft @update 2004/02/21