Интерфейс StatementEventListener

Все суперинтерфейсы:: EventListener

public interface StatementEventListener extends EventListener

Объект, регистрируемый для получения уведомлений о событиях, происходящих с PreparedStatements, находящимися в пуле операторов.

Спецификация JDBC 3.0 добавила свойство maxStatements ConnectionPooledDataSource, чтобы предоставить стандартный механизм включения пулов PreparedStatements и указания размера пула операторов. Однако у драйвера не было возможности уведомить внешний пул операторов о том, что PreparedStatement становится недействительным. В некоторых базах данных оператор становится недействительным, если выполняется операция DDL, затрагивающая таблицу. Например, приложение может создать временную таблицу для выполнения некоторых операций, а затем удалить её. Позже оно может повторно создать ту же таблицу, когда она снова понадобится. Некоторые базы данных аннулируют все подготовленные операторы, ссылающиеся на временную таблицу, при её удалении.

Как и методы, определённые в интерфейсе ConnectionEventListener, драйвер вызовет метод StatementEventListener.statementErrorOccurred до выбрасывания исключений, если обнаружит, что оператор недействителен. Драйвер также вызовет метод StatementEventListener.statementClosed при закрытии PreparedStatement.

В интерфейс PooledConnection добавлены методы, позволяющие компоненту зарегистрировать StatementEventListener в PooledConnection.

Начиная с версии:: 1.6

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`statementClosed(StatementEvent event)`	Драйвер вызывает этот метод для всех `StatementEventListener`s, зарегистрированных для соединения, когда обнаруживает, что `PreparedStatement` закрыт.
`void`	`statementErrorOccurred(StatementEvent event)`	Драйвер вызывает этот метод для всех `StatementEventListener`s, зарегистрированных для соединения, когда обнаруживает, что `PreparedStatement` недействителен.

Подробное описание методов

statementClosed

void statementClosed(StatementEvent event)

Драйвер вызывает этот метод для всех StatementEventListeners, зарегистрированных для соединения, когда обнаруживает, что PreparedStatement закрыт.

Параметры:: event — объект события, описывающий источник события и факт закрытия PreparedStatement.
Начиная с версии:: 1.6

statementErrorOccurred

void statementErrorOccurred(StatementEvent event)

Драйвер вызывает этот метод для всех StatementEventListeners, зарегистрированных для соединения, когда обнаруживает, что PreparedStatement недействителен. Драйвер вызывает этот метод непосредственно перед тем, как выбросить в приложение SQLException, содержащееся в заданном событии.

Параметры:: event — объект события, описывающий источник события, недействительный оператор и исключение, которое драйвер собирается выбросить. Источником события является PooledConnection, с которым связан недействительный PreparedStatement.
Начиная с версии:: 1.6

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.sql/javax/sql/StatementEventListener.html