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