javax.sql

Интерфейсный StatementEventListener

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

EventListener

public interface StatementEventListener
extends EventListener

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

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

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

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

С тех пор:

1.6

Сводка метода

Методы

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

Деталь метода

statementClosed

void statementClosed(StatementEvent event)

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

Параметры:

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

С тех пор:

1.6

statementErrorOccurred

void statementErrorOccurred(StatementEvent event)

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

Параметры:

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

С тех пор:

1.6