javax.sql
介面 StatementEventListener

所有父級介面：

EventListener

public interface StatementEventListener
extends EventListener

註冊為能獲得 Statement 池中 PreparedStatement 上所發生事件的通知的物件。

JDBC 3.0 規範添加了 maxStatement ConnectionPooledDataSource 屬性，以為啟用 PreparedStatement 的池操作提供標準機制並指定語句池的大小。然而，當 PreparedStatement 變為無效時，驅動程序無法通知外部語句池。對於某些資料庫，如果執行影響表的 DDL 操作，則語句將變為無效。例如，應用程序可以創建一個臨時表，在表上進行某些操作然後銷毀它。再次需要時，應用程序還可重新創建相同的表。銷毀該表後，某些資料庫將使所有參考該臨時表的準備語句無效。

與 ConnectionEventListener 介面中定義的方法類似，驅動程序檢測到語句無效時將在拋出異常之前調用 StatementEventListener.statementErrorOccurred 方法。PreparedStatement 關閉時，驅動程序也將調用 StatementEventListener.statementClosed 方法。

允許元件使用 PooledConnection 註冊 StatementEventListener 的方法已經被添加到 PooledConnection 介面。

從以下版本開始：

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