Интерфейс 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)

Параметры:

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

С:

1.6