javax.sql

インタフェース ConnectionEventListener

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

EventListener

public interface ConnectionEventListener
extends EventListener

PooledConnection オブジェクトによって生成されたイベントが通知されるよう登録するオブジェクトです。

ConnectionEventListener インタフェースは、接続プールコンポーネントによって実装されています。接続プールコンポーネントは、通常、JDBC ドライバのベンダーやほかのシステムソフトウェアベンダーによって提供されています。JDBC ドライバは、リスナーが登録に使用したプールされた接続の使用をアプリケーションが終了したときに、ConnectionEventListener オブジェクトに通知します。この通知は、アプリケーションが PooledConnection オブジェクトの表現上で close メソッドを呼び出したあとで発生します。サーバーに障害が発生したなどの理由で PooledConnection が今後の使用に不適当であるために接続エラーが発生したときは、ConnectionEventListener も通知されます。リスナーには、PooledConnection オブジェクトを使用しているアプリケーションにドライバが SQLException をスローする直前に、JDBC ドライバによって通知されます。

導入されたバージョン:

1.4

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	connectionClosed(ConnectionEvent event) アプリケーションがプールされた接続の表現上で close メソッドを呼び出したことを意味する ConnectionEventListener を通知します。
void	connectionErrorOccurred(ConnectionEvent event) 致命的エラーが発生し、プールされた接続が使用できなくなったことを意味する ConnectionEventListener を通知します。

メソッドの詳細

connectionClosed

void connectionClosed(ConnectionEvent event)

アプリケーションがプールされた接続の表現上で close メソッドを呼び出したことを意味する ConnectionEventListener を通知します。

パラメータ:

event - イベントのソースを記述したイベントオブジェクト

connectionErrorOccurred

void connectionErrorOccurred(ConnectionEvent event)

致命的エラーが発生し、プールされた接続が使用できなくなったことを意味する ConnectionEventListener を通知します。指定した ConnectionEvent オブジェクトに含まれる SQLException がアプリケーションにスローされる直前に、ドライバによってこの通知が作成されます。

パラメータ:

event - イベントのソースを記述したイベントオブジェクト。ドライバがスローする予定の SQLException を含む