Интерфейс StatementEventListener

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

public interface StatementEventListener extends EventListener

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

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

Аналогично методам, определённым в интерфейсе ConnectionEventListener, драйвер вызовет метод StatementEventListener.statementErrorOccurred перед выбросом любых исключений, когда обнаружит, что statement недействителен. Драйвер также вызовет метод 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 - объект события, описывающий источник события, недействительный statement и исключение, которое драйвер собирается выбросить. Источником события является PooledConnection, с которым связан недействительный PreparedStatement.
С:: 1.6

© 1993, 2021, 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/17/docs/api/java.sql/javax/sql/StatementEventListener.html