public interface StatementEventListener
implements EventListener
javax.sql.StatementEventListener |
一个对象,用于通知在Statement池中的PreparedStatements上发生的事件。
JDBC 3.0规范添加了maxStatements ConnectionPooledDataSource
属性,以提供标准机制来启用池PreparedStatements
并指定语句池的大小。 但是,当PreparedStatement
变得无效时,驱动程序无法通知外部语句池。 对于某些数据库,如果执行影响表的DDL操作,则语句将变为无效。 例如,应用程序可能会创建一个临时表来在表上做一些工作,然后将其销毁。 当它再次需要时,它可能稍后重新创建同一个表。 某些数据库将使删除表时引用临时表的任何预准备语句无效。
与ConnectionEventListener
界面中定义的方法类似,驱动程序在检测到语句无效时会在抛出任何异常之前调用StatementEventListener.statementErrorOccurred
方法。 PreparedStatement
关闭时,司机还会致电StatementEventListener.statementClosed
方法。
允许组件向 PooledConnection
注册StatementEventListener的 PooledConnection
已添加到 PooledConnection
接口。
Public methods |
|
---|---|
abstract void |
statementClosed(StatementEvent event) 当它检测到 |
abstract void |
statementErrorOccurred(StatementEvent event) 当它检测到 |
void statementClosed (StatementEvent event)
当它检测到 PreparedStatement
已关闭时,驱动程序在连接上注册的所有 StatementEventListener
上调用此方法。
Parameters | |
---|---|
event |
StatementEvent : an event object describing the source of the event and that the PreparedStatement was closed. |
void statementErrorOccurred (StatementEvent event)
当它检测到PreparedStatement
无效时,驱动程序在连接上注册的所有StatementEventListener
上调用此方法。 驱动程序在将包含在给定事件中的SQLException
引发到应用程序之前调用此方法。
Parameters | |
---|---|
event |
StatementEvent : an event object describing the source of the event, the statement that is invalid and the exception the driver is about to throw. The source of the event is the PooledConnection which the invalid PreparedStatement is associated with. |