Most visited

Recently visited

Added in API level 9

StatementEventListener

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接口。

Summary

Public methods

abstract void statementClosed(StatementEvent event)

当它检测到 PreparedStatement已关闭时,驱动程序在连接上注册的所有 StatementEventListener上调用此方法。

abstract void statementErrorOccurred(StatementEvent event)

当它检测到 PreparedStatement无效时,驱动程序在连接上注册的所有 StatementEventListener上调用此方法。

Public methods

statementClosed

Added in API level 9
void statementClosed (StatementEvent event)

当它检测到 PreparedStatement已关闭时,驱动程序在连接上注册的所有 StatementEventListener上调用此方法。

Parameters
event StatementEvent: an event object describing the source of the event and that the PreparedStatement was closed.

statementErrorOccurred

Added in API level 9
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.

Hooray!