Интерфейс StatementEventListener

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

public interface StatementEventListener extends EventListener

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

Спецификация 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, 2023, 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/21/docs/api/java.sql/javax/sql/StatementEventListener.html