compact2, compact3

javax.sql

インタフェースStatementEventListener

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

EventListener

public interface StatementEventListener
extends EventListener

Statementプール内のPreparedStatementで発生したイベントの通知を受けるように登録されているオブジェクトです。

PreparedStatementsのプールを有効にする標準のメカニズムを提供し、文のプールのサイズを指定する目的で、JDBC 3.0仕様に、maxStatementsのConnectionPooledDataSourceプロパティが追加されました。ただし、PreparedStatementが無効になった場合に、ドライバが外部の文のプールに通知する手段はありませんでした。一部のデータベースでは、テーブルに影響を及ぼすDDL処理が実行されると、文が無効になります。たとえば、テーブルに対してなんらかの処理を実行する際、一時テーブルを作成して破棄するようなアプリケーションがあるとします。このアプリケーションは、あとで必要になったときに、同じテーブルを再度作成する可能性があります。一部のデータベースは、一時テーブルが破棄されると、この一時テーブルを参照する用意された文を無効にします。

ConnectionEventListenerインタフェースで定義されているメソッドと同様に、ドライバは、文が無効であることを検出すると、例外をスローする前にStatementEventListener.statementErrorOccurredメソッドを呼び出します。PreparedStatementが閉じられると、ドライバは、さらにStatementEventListener.statementClosedメソッドを呼び出します。

PooledConnectionインタフェースには、コンポーネントがPooledConnectionにStatementEventListenerを登録することを許可するメソッドが追加されています。

導入されたバージョン:

1.6

メソッドのサマリー

修飾子と型	メソッドと説明
void	statementClosed(StatementEvent event) ドライバは、PreparedStatementが閉じられたことを検出すると、接続上の登録されているすべてのStatementEventListenerで、このメソッドを呼び出します。
void	statementErrorOccurred(StatementEvent event) ドライバは、PreparedStatementが無効であることを検出すると、接続上の登録されているすべてのStatementEventListenerで、このメソッドを呼び出します。

メソッドの詳細

statementClosed

void statementClosed(StatementEvent event)

ドライバは、PreparedStatementが閉じられたことを検出すると、接続上の登録されているすべてのStatementEventListenerで、このメソッドを呼び出します。

パラメータ:

event - イベントのソースと、PreparedStatementが閉じられたことを記述するイベント・オブジェクト。

導入されたバージョン:

1.6

statementErrorOccurred

void statementErrorOccurred(StatementEvent event)

ドライバは、PreparedStatementが無効であることを検出すると、接続上の登録されているすべてのStatementEventListenerで、このメソッドを呼び出します。ドライバは、指定されたイベントに含まれるSQLExceptionをアプリケーションにスローする直前に、このメソッドを呼び出します。

パラメータ:

event - イベントのソース、無効な文、およびドライバがスローしようとしている例外を記述するイベント・オブジェクト。イベントのソースは、無効なPreparedStatementが関連付けられているPooledConnection。

導入されたバージョン:

1.6