javax.sql
インタフェース PooledConnection

既知のサブインタフェースの一覧:

XAConnection

public interface PooledConnection

接続プール管理のフックを提供するオブジェクトです。PooledConnection オブジェクトは、データソースへの物理接続を表します。アプリケーションがある接続で終了したとき、その接続は閉じられずにリサイクルされます。そのため、生成する必要のある接続数を減らすことができます。

アプリケーションプログラマが PooledConnection インタフェースを直接使用することはありません。むしろ、PooledConnection インタフェースは、接続のプーリングを管理する中間層インフラストラクチャが使用します。

導入されたバージョン:

1.4

メソッドの概要

void	addConnectionEventListener(ConnectionEventListener listener) 指定したイベントリスナーを登録して、この PooledConnection オブジェクトでイベントが発生したときに通知されるようにします。
void	close() この PooledConnection オブジェクトが表す物理接続を閉じます。
Connection	getConnection() この PooledConnection オブジェクトが表す物理接続のオブジェクトハンドルを作成します。
void	removeConnectionEventListener(ConnectionEventListener listener) 指定したイベントリスナーを、この PooledConnection オブジェクトでイベントが発生したときに通知されるコンポーネントのリストから削除します。

メソッドの詳細

getConnection

public Connection getConnection()
                         throws SQLException

この PooledConnection オブジェクトが表す物理接続のオブジェクトハンドルを作成します。返されるオブジェクトは、プールされている物理接続 (この PooledConnection オブジェクト) を参照するアプリケーションコードで使用する一時ハンドルになります。

戻り値:

この PooledConnection オブジェクトのハンドルである Connection オブジェクト

例外:

SQLException - データベースアクセスエラーが発生した場合

close

public void close()
           throws SQLException

この PooledConnection オブジェクトが表す物理接続を閉じます。

例外:

SQLException - データベースアクセスエラーが発生した場合

addConnectionEventListener

public void addConnectionEventListener(ConnectionEventListener listener)

指定したイベントリスナーを登録して、この PooledConnection オブジェクトでイベントが発生したときに通知されるようにします。

パラメータ:

listener - ConnectionEventListener インタフェースを実装し、接続が閉じたかエラーが発生したときに通知されるようにするコンポーネント。通常は接続プール管理プログラム

関連項目:

removeConnectionEventListener(javax.sql.ConnectionEventListener)

removeConnectionEventListener

public void removeConnectionEventListener(ConnectionEventListener listener)

指定したイベントリスナーを、この PooledConnection オブジェクトでイベントが発生したときに通知されるコンポーネントのリストから削除します。

パラメータ:

listener - ConnectionEventListener インタフェースを実装し、リスナーとして登録されたコンポーネント。通常は接続プール管理プログラム

関連項目:

addConnectionEventListener(javax.sql.ConnectionEventListener)