Module  java.sql
软件包  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注册StatementEventListener的PooledConnection已添加到PooledConnection接口。

    从以下版本开始：
    1.6

    • 方法摘要

      所有方法  接口方法  抽象方法 
      Modifier and Type 方法 描述
      void statementClosed​(StatementEvent event)
      当驱动程序检测到一个 PreparedStatement关闭时，驱动程序会在连接上注册的所有 StatementEventListener上都调用此方法。
      void statementErrorOccurred​(StatementEvent event)
      当驱动程序检测到 PreparedStatement无效时，驱动程序会在连接上注册的所有 StatementEventListener s上调用此方法。

    • 方法详细信息

      • statementClosed

        void statementClosed​(StatementEvent event)
        当驱动程序检测到 PreparedStatement已关闭时，驱动程序会在连接上注册的所有 StatementEventListener上都调用此方法。
        参数
        event - 描述事件源的事件对象，并关闭 PreparedStatement 。
        从以下版本开始：
        1.6

      • statementErrorOccurred

        void statementErrorOccurred​(StatementEvent event)
        当驱动程序检测到PreparedStatement无效时，该连接上注册的所有StatementEventListener调用此方法。 驱动程序在将该给定事件中包含的SQLException到应用程序之前调用此方法。
        参数
        event - 描述事件源的事件对象，无效的语句以及驱动程序即将抛出的异常。 事件的来源是PooledConnection与无效的PreparedStatement相关联。
        从以下版本开始：
        1.6