17.6.3　PooledConnectionインタフェース

Connectionオブジェクトは，HiRDBサーバとの物理接続と1対1の関係となり，必要に応じて物理接続が行われ，Connectionオブジェクトが返されます。

public synchronized Connection getConnection() throws SQLException

なし。

Connectionオブジェクト

Connectionオブジェクトは，HiRDBサーバとの物理接続と1対1の関係となり，必要に応じて物理接続が行われ，Connectionオブジェクトが返されます。一度接続した物理接続は，このクラスオブジェクトがクローズされるまで切断されません。Connectionオブジェクトに対してcloseメソッドを実行しても，物理接続の切断はしないで，このクラスオブジェクトが物理接続を保持します。保持した物理接続は，次のこのメソッド呼び出しによる接続要求で再利用します（setLoginTimeoutやクライアント環境定義PDCONNECTWAITTIMEで指定した待ち時間は発生しません）。

次の場合はSQLExceptionを投入します。

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

• 指定した接続情報が不正の場合

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

public synchronized void addConnectionEventListener(ConnectionEventListener listener)

ConnectionEventListener listener：

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

なし。

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

addConnectionEventListenerメソッドで登録したイベントリスナから，このドライバのメソッドを呼び出すことはできません。呼び出した場合，（デッドロックによって）このドライバからの応答がなくなることがあります。

なし。

物理接続の切断をします。

public synchronized void close()

なし。

なし。

プールされたすべての接続に対し，物理接続の切断をします。Connectionオブジェクトを取得してデータベースアクセスを行っている最中でも，PooledConnection.close()の実行で物理切断を試みます。

なし。

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

public synchronized void removeConnectionEventListener(ConnectionEventListener listener)

ConnectionEventListener listener：

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

なし。

なし。

引数で指定したStatementEventListenerをPooledConnectionに登録します。

public synchronized void addStatementEventListener(StatementEventListener listener)

StatementEventListener listener：

StatementEventListener インタフェースを実装し，前処理結果が無効となるエラーが発生したときに通知を受けるためのオブジェクトです。

なし。

引数で指定したStatementEventListenerをPooledConnectionに登録して，PreparedStatement（又はCallableStatement）オブジェクトが無効となるSQLExceptionが発生したときに通知を受けられるようにします。引数listenerがnullの場合，何も行いません。

なし。

このメソッドの最初の呼び出し前に生成したPreparedStatement（又はCallableStatement）オブジェクトは通知の対象になりません。イベント通知対象となるPreparedStatementの例を次に示します。

PooledConnection pcon = ConnectionPoolDataSource.getPooledConnection();
Connection con = pcon.getConnection();
PreparedStatement pstmt1 = con.prepareStatement(<SQL文A>);   ←イベント通知対象外
pcon.addStatementEventListener(listener);
PreparedStatement pstmt2 = con.prepareStatement(<SQL文B>);   ←イベント通知対象

引数で指定したStatementEventListenerをPooledConnectionから削除します。

public synchronized void removeStatementEventListener(StatementEventListener listener)

StatementEventListener listener：

addStatementEventListenerメソッドでPooledConnectionに登録済みのオブジェクトです。

なし。

addStatementEventListenerメソッドで登録済みのStatementEventListenerを，PooledConnectionが持つリストから削除します。引数listenerがnullの場合，及び対応するStatementEventListenerが存在しない場合は，何も行いません。

なし。