Интерфейс EventContext

public interface EventContext extends Context

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

Целевой объект

Параметр имени в методах 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 необходимо соблюдать осторожность. Дополнительные сведения о проблемах многопоточности см. в описании пакета.