compact2, compact3

javax.sql

Interface StatementEventListener

All Superinterfaces:

EventListener

public interface StatementEventListener
extends EventListener

注册在“声明”池中的PreparedStatements上发生的事件的通知对象。

JDBC 3.0规范添加maxStatements ConnectionPooledDataSource属性为启用的池提供的标准机制PreparedStatements并指定语句池的大小。 但是， PreparedStatement无效时，驱动程序无法通知外部语句池。 对于某些数据库，如果执行影响该表的DDL操作，则该语句将变为无效。 例如，一个应用程序可能创建一个临时表来对表进行一些工作，然后将其破坏。 它可能会在需要时重新创建相同的表。 某些数据库将在删除表时引用临时表的任何预准备语句失效。

类似于ConnectionEventListener接口中定义的方法，当驱动程序检测到语句无效时，驱动程序将在抛出任何异常之前调用StatementEventListener.statementErrorOccurred方法。 当一个PreparedStatement关闭时，司机也会调用StatementEventListener.statementClosed方法。

允许组件注册具有PooledConnection的PooledConnection的方法已添加到PooledConnection接口。

从以下版本开始：

1.6

方法摘要

Modifier and Type	Method and Description
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 - 描述事件源的事件对象，无效的语句以及驱动程序即将抛出的异常。 事件的源是PooledConnection其中无效PreparedStatement相关联。

从以下版本开始：

1.6