鴻蒙OS StatementEventListener

StatementEventListener

public interface StatementEventListener
extends EventListener

一個(gè)對(duì)象，它注冊(cè)以通知在語(yǔ)句池中的 PreparedStatements 上發(fā)生的事件。

JDBC 3.0 規(guī)范添加了 maxStatements ConnectionPooledDataSource 屬性，以提供啟用 PreparedStatements 池的標(biāo)準(zhǔn)機(jī)制并指定語(yǔ)句池的大小。但是，當(dāng) PreparedStatement 無(wú)效時(shí)，驅(qū)動(dòng)程序無(wú)法通知外部語(yǔ)句池。對(duì)于某些數(shù)據(jù)庫(kù)，如果執(zhí)行了影響表的 DDL 操作，則語(yǔ)句將變?yōu)闊o(wú)效。例如，應(yīng)用程序可能會(huì)創(chuàng)建一個(gè)臨時(shí)表來(lái)對(duì)該表執(zhí)行一些工作，然后將其銷毀。它可能會(huì)在以后再次需要時(shí)重新創(chuàng)建同一個(gè)表。某些數(shù)據(jù)庫(kù)會(huì)在刪除表時(shí)使引用臨時(shí)表的任何準(zhǔn)備好的語(yǔ)句無(wú)效。

與 ConnectionEventListener 接口中定義的方法類似，驅(qū)動(dòng)程序在檢測(cè)到語(yǔ)句無(wú)效時(shí)會(huì)在拋出任何異常之前調(diào)用 StatementEventListener.statementErrorOccurred 方法。當(dāng) PreparedStatement 關(guān)閉時(shí)，驅(qū)動(dòng)程序還將調(diào)用 StatementEventListener.statementClosed 方法。

允許組件向 PooledConnection 注冊(cè) StatementEventListener 的方法已添加到 PooledConnection 接口中。

Since:

1.6

方法總結(jié)

方法詳情

statementClosed

void statementClosed(StatementEvent event)

驅(qū)動(dòng)程序在檢測(cè)到 PreparedStatement 已關(guān)閉時(shí)，對(duì)連接上注冊(cè)的所有 StatementEventListener 調(diào)用此方法。

參數(shù)：

Since:

1.6

statementErrorOccurred

void statementErrorOccurred(StatementEvent event)

驅(qū)動(dòng)程序在檢測(cè)到 PreparedStatement 無(wú)效時(shí)，對(duì)連接上注冊(cè)的所有 StatementEventListener 調(diào)用此方法。 驅(qū)動(dòng)程序在將給定事件中包含的 SQLException 拋出給應(yīng)用程序之前調(diào)用此方法。

參數(shù)：

Since:

1.6