Интерфейс 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.
• На экземпляре EventContext, в котором он зарегистрирован, вызывается Context.close().

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

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

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

Проблемы многопоточности

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