Интерфейс EventContext

public interface EventContext extends Context

Содержит методы для регистрации/дерегистрации слушателей, которые должны быть уведомлены об событиях, сгенерированных при изменении объектов, указанных в контексте.

Целевое значение

Параметр name в методах addNamingListener() называется целевым значением. Целевое значение, наряду с областью видимости, определяет объект(ы), к которым слушатель проявляет интерес. Можно зарегистрировать интерес к целевому значению, которое не существует, но могут быть ограничения в том, насколько это поддерживается поставщиком сервиса и базовым протоколом/сервисом.

Если сервис поддерживает регистрацию только для существующих целевых значений, попытка зарегистрироваться для несуществующего целевого значения приведёт к выбрасыванию исключения NameNotFoundException как можно раньше, предпочтительно в момент вызова addNamingListener(), или, если это невозможно, слушатель получит исключение через NamingExceptionEvent.

Кроме того, для поставщиков сервисов, которые поддерживают регистрацию только для существующих целевых значений, когда целевое значение, для которого зарегистрирован слушатель, впоследствии удаляется из пространства имён, слушатель уведомляется посредством NamingExceptionEvent (содержащего NameNotFoundException).

Приложение может использовать метод targetMustExist() для проверки, поддерживает ли EventContext регистрацию несуществующих целевых значений.

Источник события

Экземпляр EventContext, на котором вы вызываете методы регистрации, является источником события событий, которые (потенциально) генерируются. Источник не обязательно является объектом, указанным целевым значением. Только когда целевое значение является пустым именем, объект, указанный целевым значением, является источником. Другими словами, целевое значение, наряду с параметром области видимости, используется для идентификации объекта(ов), к которому слушатель проявляет интерес, но источником события является экземпляр EventContext, с которым слушатель зарегистрирован.

Например, предположим, что слушатель выполняет следующую регистрацию:

      NamespaceChangeListener listener = ...;
      src.addNamingListener("x", SUBTREE_SCOPE, listener);

Когда объект с именем "x/y" впоследствии удаляется, соответствующее NamingEvent (evt) должно содержать:

      evt.getEventContext() == src
      evt.getOldBinding().getName().equals("x/y")

Кроме того, регистрация/дерегистрация слушателей осуществляется с экземпляром EventContext, а не с соответствующим объектом в пространстве имён. Если программа планирует в какой-то момент удалить слушателя, ей нужно сохранить ссылку на экземпляр EventContext, на котором она вызвала addNamingListener() (точно так же, как ей нужно сохранить ссылку на слушателя, чтобы удалить его позже). Она не может ожидать выполнить lookup() и получить другой экземпляр EventContext, на котором выполнить дерегистрацию.

Срок действия регистрации

Зарегистрированный слушатель становится дерегистрированным, когда:

• Он удаляется с помощью removeNamingListener().
• Выбрасывается исключение во время сбора информации о событиях. То есть, когда слушатель получает NamingExceptionEvent.
• Context.close() вызывается на экземпляре EventContext, с которым он зарегистрирован.

До этого момента экземпляр EventContext, у которого есть ожидающие слушатели, будет продолжать существовать и обслуживаться поставщиком сервиса.

Реализации слушателей

Методы регистрации/дерегистрации принимают экземпляр интерфейса NamingListener. Существуют подинтерфейсы NamingListener для различных типов событий NamingEvent. Например, интерфейс ObjectChangeListener предназначен для типа события NamingEvent.OBJECT_CHANGED. Чтобы зарегистрировать интерес к нескольким типам событий, реализация слушателя должна реализовывать несколько подинтерфейсов NamingListener и использовать один вызов addNamingListener(). Кроме сокращения количества вызовов методов и, возможно, размера кода слушателей, это позволяет некоторым поставщикам сервисов оптимизировать регистрацию.

Проблемы с потоками

Как и экземпляры Context вообще, экземпляры EventContext не гарантируют потокобезопасность. Необходимо соблюдать осторожность при одновременном доступе к одному и тому же экземпляру EventContext из нескольких потоков. Подробнее о проблемах с потоками см. в описании пакета.