Интерфейс 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. Более подробную информацию о проблемах потоков см. в описании пакета в описании пакета.