org.apache.commons.dbcp
クラス PoolableConnectionFactory

java.lang.Object
  org.apache.commons.dbcp.PoolableConnectionFactory

すべての実装インタフェース:

org.apache.commons.pool.PoolableObjectFactory

public class PoolableConnectionFactory

extends Object

implements org.apache.commons.pool.PoolableObjectFactory

PoolableConnection を生成する PoolableObjectFactory です。

A {@link PoolableObjectFactory} that creates {@link PoolableConnection}s.

バージョン:

$Id: PoolableConnectionFactory.java,v 1.1.1.1 2004/02/13 10:02:03 hioki Exp $

作成者:

Rodney Waldhoff, Glenn L. Nielsen, James House (james@interobjective.com)

翻訳者:

日置 聡

翻訳状況:

初稿(校正者募集中)

翻訳更新日:

2003/09/19

フィールドの概要

protected AbandonedConfig	_config
protected ConnectionFactory	_connFactory
protected boolean	_defaultAutoCommit
protected boolean	_defaultReadOnly
protected org.apache.commons.pool.ObjectPool	_pool
protected org.apache.commons.pool.KeyedObjectPoolFactory	_stmtPoolFactory
protected String	_validationQuery

コンストラクタの概要

PoolableConnectionFactory(ConnectionFactory connFactory, org.apache.commons.pool.ObjectPool pool, org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory, String validationQuery, boolean defaultReadOnly, boolean defaultAutoCommit)
新たな PoolableConnectionFactory を生成します。

PoolableConnectionFactory(ConnectionFactory connFactory, org.apache.commons.pool.ObjectPool pool, org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory, String validationQuery, boolean defaultReadOnly, boolean defaultAutoCommit, AbandonedConfig config)
新たな PoolableConnectionFactory を生成します。

メソッドの概要

void	activateObject(Object obj)
void	destroyObject(Object obj)
org.apache.commons.pool.ObjectPool	getPool()
Object	makeObject()
void	passivateObject(Object obj)
void	setConnectionFactory(ConnectionFactory connFactory) ベースとなる Connection の取得元となる ConnectionFactory を設定します。
void	setDefaultAutoCommit(boolean defaultAutoCommit) 貸し出される Connection のデフォルトの "auto commit" の設定を設定します。
void	setDefaultReadOnly(boolean defaultReadOnly) 貸し出される Connection のデフォルトの "read only" の設定を設定します。
void	setPool(org.apache.commons.pool.ObjectPool pool) Connection をプールする ObjectPool を設定します。
void	setStatementPoolFactory(org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory) プールする PreparedStatement のための KeyedObjectPool を生成するために使用されるKeyedObjectPoolFactory を設定します。
void	setValidationQuery(String validationQuery) Connection の チェック に使用される少なくとも1つの列を返すクエリを設定します。
boolean	validateObject(Object obj)

クラス java.lang.Object から継承したメソッド

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

フィールドの詳細

_config

protected AbandonedConfig _config

_connFactory

protected ConnectionFactory _connFactory

_defaultAutoCommit

protected boolean _defaultAutoCommit

_defaultReadOnly

protected boolean _defaultReadOnly

_pool

protected org.apache.commons.pool.ObjectPool _pool

_stmtPoolFactory

protected org.apache.commons.pool.KeyedObjectPoolFactory _stmtPoolFactory

_validationQuery

protected String _validationQuery

コンストラクタの詳細

PoolableConnectionFactory

public PoolableConnectionFactory(ConnectionFactory connFactory,
                                 org.apache.commons.pool.ObjectPool pool,
                                 org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory,
                                 String validationQuery,
                                 boolean defaultReadOnly,
                                 boolean defaultAutoCommit)
                          throws Exception

新たな PoolableConnectionFactory を生成します。

Create a new PoolableConnectionFactory.

パラメータ:

connFactory - ベースとなる Connection の取得元となる ConnectionFactory

the {@link ConnectionFactory} from which to obtain base {@link Connection}s

pool - Connection をプールする ObjectPool

the {@link ObjectPool} in which to pool those {@link Connection}s

stmtPoolFactory - プールする PreparedStatement のための KeyedObjectPool を生成するために使用されるKeyedObjectPoolFactory 、 PreparedStatement のプールを無効とする場合には null

the {@link KeyedObjectPoolFactory} to use to create {@link KeyedObjectPool}s for pooling {@link java.sql.PreparedStatement}s, or null to disable {@link java.sql.PreparedStatement} pooling

validationQuery - Connection の チェック に使用される少なくとも1つの列を返すクエリ、null を許容します

a query to use to {@link #validateObject validate} {@link Connection}s. Should return at least one row. May be null

defaultReadOnly - 返される Connection に対するデフォルトの "read only" の設定

the default "read only" setting for borrowed {@link Connection}s

defaultAutoCommit - 返される Connection に対するデフォルトの "auto commit" の設定

the default "auto commit" setting for returned {@link Connection}s

PoolableConnectionFactory

public PoolableConnectionFactory(ConnectionFactory connFactory,
                                 org.apache.commons.pool.ObjectPool pool,
                                 org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory,
                                 String validationQuery,
                                 boolean defaultReadOnly,
                                 boolean defaultAutoCommit,
                                 AbandonedConfig config)

新たな PoolableConnectionFactory を生成します。

Create a new PoolableConnectionFactory.

パラメータ:

connFactory - ベースとなる Connection の取得元となる ConnectionFactory

the {@link ConnectionFactory} from which to obtain base {@link Connection}s

pool - Connection をプールする ObjectPool

the {@link ObjectPool} in which to pool those {@link Connection}s

stmtPoolFactory - プールする PreparedStatement のための KeyedObjectPool を生成するために使用されるKeyedObjectPoolFactory 、 PreparedStatement のプールを無効とする場合には null

the {@link KeyedObjectPoolFactory} to use to create {@link KeyedObjectPool}s for pooling {@link java.sql.PreparedStatement}s, or null to disable {@link java.sql.PreparedStatement} pooling

validationQuery - Connection の チェック に使用される少なくとも1つの列を返すクエリ、null を許容します

a query to use to {@link #validateObject validate} {@link Connection}s. Should return at least one row. May be null

defaultReadOnly - 返される Connection に対するデフォルトの "read only" の設定

the default "read only" setting for borrowed {@link Connection}s

defaultAutoCommit - 返される Connection に対するデフォルトの "auto commit" の設定

the default "auto commit" setting for returned {@link Connection}s

config - SQLオブジェクトをトレースする場合の AbandonedConfig

the AbandonedConfig if tracing SQL objects

メソッドの詳細

activateObject

public void activateObject(Object obj)
                    throws Exception

定義:

インタフェース org.apache.commons.pool.PoolableObjectFactory 内の activateObject

例外:

Exception

destroyObject

public void destroyObject(Object obj)
                   throws Exception

定義:

インタフェース org.apache.commons.pool.PoolableObjectFactory 内の destroyObject

例外:

Exception

getPool

public org.apache.commons.pool.ObjectPool getPool()

makeObject

public Object makeObject()
                  throws Exception

定義:

インタフェース org.apache.commons.pool.PoolableObjectFactory 内の makeObject

例外:

Exception

passivateObject

public void passivateObject(Object obj)
                     throws Exception

定義:

インタフェース org.apache.commons.pool.PoolableObjectFactory 内の passivateObject

例外:

Exception

setConnectionFactory

public void setConnectionFactory(ConnectionFactory connFactory)

ベースとなる Connection の取得元となる ConnectionFactory を設定します。

Sets the {@link ConnectionFactory} from which to obtain base {@link Connection}s.

パラメータ:

connFactory - ベースとなる Connection の取得元となる ConnectionFactory

the {@link ConnectionFactory} from which to obtain base {@link Connection}s

setDefaultAutoCommit

public void setDefaultAutoCommit(boolean defaultAutoCommit)

貸し出される Connection のデフォルトの "auto commit" の設定を設定します。

Sets the default "auto commit" setting for borrowed {@link Connection}s

パラメータ:

defaultAutoCommit - 貸し出される Connection のデフォルトの "auto commit" の設定

the default "auto commit" setting for borrowed {@link Connection}s

setDefaultReadOnly

public void setDefaultReadOnly(boolean defaultReadOnly)

貸し出される Connection のデフォルトの "read only" の設定を設定します。

Sets the default "read only" setting for borrowed {@link Connection}s

パラメータ:

defaultReadOnly - 貸し出される Connection のデフォルトの "read only" の設定

the default "read only" setting for borrowed {@link Connection}s

setPool

public void setPool(org.apache.commons.pool.ObjectPool pool)

Connection をプールする ObjectPool を設定します。

Sets the {@link ObjectPool} in which to pool {@link Connection}s.

パラメータ:

pool - Connection をプールする ObjectPool

the {@link ObjectPool} in which to pool those {@link Connection}s

setStatementPoolFactory

public void setStatementPoolFactory(org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory)

プールする PreparedStatement のための KeyedObjectPool を生成するために使用されるKeyedObjectPoolFactory を設定します。 PreparedStatement のプールを無効とする場合には null を設定します。

Sets the {@link KeyedObjectPoolFactory} I use to create {@link KeyedObjectPool}s for pooling {@link java.sql.PreparedStatement}s. Set to null to disable {@link java.sql.PreparedStatement} pooling.

パラメータ:

stmtPoolFactory - プールする PreparedStatement のための KeyedObjectPool を生成するために使用されるKeyedObjectPoolFactory

the {@link KeyedObjectPoolFactory} to use to create {@link KeyedObjectPool}s for pooling {@link java.sql.PreparedStatement}s

setValidationQuery

public void setValidationQuery(String validationQuery)

Connection の チェック に使用される少なくとも1つの列を返すクエリを設定します。 null を許容します。

Sets the query I use to {@link #validateObject validate} {@link Connection}s. Should return at least one row. May be null

パラメータ:

validationQuery - Connection の チェック に使用されるクエリ

a query to use to {@link #validateObject validate} {@link Connection}s.

validateObject

public boolean validateObject(Object obj)

定義:

インタフェース org.apache.commons.pool.PoolableObjectFactory 内の validateObject