Интерфейс StatementEventListener

public interface StatementEventListener
extends EventListener

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

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

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

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

Методы

statementClosed

void statementClosed(StatementEvent event)

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

Параметры:

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

С момента:

1.6

statementErrorOccurred

void statementErrorOccurred(StatementEvent event)

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

Параметры:

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

С момента:

1.6