Интерфейс StatementEventListener

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

public interface StatementEventListener extends EventListener

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

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

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

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

С:: 1.6

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

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

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

statementClosed

void statementClosed(StatementEvent event)

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

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

statementErrorOccurred

void statementErrorOccurred(StatementEvent event)

Драйвер вызывает этот метод для всех StatementEventListener, зарегистрированных на соединении, когда он обнаруживает, что 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://download.java.net/java/early_access/jdk24/docs/api/java.sql/javax/sql/StatementEventListener.html