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. См. описание пакета для получения дополнительной информации о проблемах с потоками.