javax.naming.event

Интерфейсный EventContext

Все Суперинтерфейсы:

Контекст

Все Известные Подынтерфейсы:

EventDirContext

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")

Кроме того слушатель registration/deregistration с экземпляром EventContext, а не с соответствующим объектом в пространстве имен. Если программа намеревается в некоторый момент удалить слушателя, то она должна сохранить ссылку на экземпляр EventContext, на который она вызвала addNamingListener() (так же, как она должна сохранить ссылку на слушателя, чтобы удалить ее позже). Это не может ожидать делать lookup() и получать другой экземпляр EventContext, на котором можно выполнить deregistration.

Время жизни Регистрации

Зарегистрированный слушатель становится вычеркнутым из списка когда:

• Это удаляется, используя removeNamingListener().
• Исключение выдается, собирая информацию о событиях. Таким образом, когда слушатель получает NamingExceptionEvent.
• Context.close() вызывается на экземпляр EventContext, в котором он зарегистрировался.

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

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

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

Поточная обработка Проблем

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

С тех пор:

1.3

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	OBJECT_SCOPE Постоянный для того, чтобы выразить интерес к событиям относительно объекта, названного к установленному сроку.
static int	ONELEVEL_SCOPE Постоянный для того, чтобы выразить интерес к событиям относительно объектов в контексте, названном к установленному сроку, исключая контекст, названный к установленному сроку.
static int	SUBTREE_SCOPE Постоянный для того, чтобы выразить интерес к событиям относительно объектов в поддереве объекта, названного к установленному сроку, включая объект, названный к установленному сроку.

Поля, наследованные от интерфейса javax.naming. Контекст

APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addNamingListener(Name target, int scope, NamingListener l) Добавляет слушатель для того, чтобы получить события именования, запущенные, когда объект (ы), идентифицированный целью и контекстом, изменяется.
void	addNamingListener(String target, int scope, NamingListener l) Добавляет слушатель для того, чтобы получить события именования, запущенные, когда объект, названный строкой, предназначается для имени и изменений контекста.
void	removeNamingListener(NamingListener l) Удаляет слушателя из получения событий именования, запущенных этим EventContext.
boolean	targetMustExist() Определяет, может ли слушатель зарегистрировать интерес к цели, которая не существует.

Методы, наследованные от интерфейса javax.naming. Контекст

addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

Полевая Деталь

OBJECT_SCOPE

static final int OBJECT_SCOPE

Постоянный для того, чтобы выразить интерес к событиям относительно объекта, названного к установленному сроку.

Значением этой константы является 0.

См. Также:

Постоянные Значения полей

ONELEVEL_SCOPE

static final int ONELEVEL_SCOPE

Постоянный для того, чтобы выразить интерес к событиям относительно объектов в контексте, названном к установленному сроку, исключая контекст, названный к установленному сроку.

Значением этой константы является 1.

См. Также:

Постоянные Значения полей

SUBTREE_SCOPE

static final int SUBTREE_SCOPE

Постоянный для того, чтобы выразить интерес к событиям относительно объектов в поддереве объекта, названного к установленному сроку, включая объект, названный к установленному сроку.

Значением этой константы является 2.

См. Также:

Постоянные Значения полей

Деталь метода

addNamingListener

void addNamingListener(Name target,
                     int scope,
                     NamingListener l)
                       throws NamingException

Добавляет слушатель для того, чтобы получить события именования, запущенные, когда объект (ы), идентифицированный целью и контекстом, изменяется. Источник события тех событий является этим контекстом. См. описание класса для обсуждения источника события и цели. См. описания констант OBJECT_SCOPE, ONELEVEL_SCOPE, и SUBTREE_SCOPE, чтобы видеть, как scope влияет на регистрацию.

target должен назвать контекст только, когда scope является ONELEVEL_SCOPE. target может назвать неконтекст, если scope является или OBJECT_SCOPE или SUBTREE_SCOPE. Используя SUBTREE_SCOPE для неконтекста могло бы быть полезным, например, если вызывающая сторона не знает заранее, является ли target контекстом и только хочет зарегистрировать интерес к (возможно, выродившееся поддерево) базировался в target.

Когда слушатель уведомляется относительно события, май слушателя в вызванном в потоке кроме того, в котором выполняется addNamingListener(). Забота должна быть проявлена, когда многократные потоки получают доступ к тому же самому EventContext одновременно. См. описание пакета для получения дополнительной информации о поточной обработке проблем.

Параметры:

target - Ненулевое имя, которое будет разрешено относительно этого контекста.

scope - Один из OBJECT_SCOPE, ONELEVEL_SCOPE, или SUBTREE_SCOPE.

l - Ненулевой слушатель.

Броски:

NamingException - Если с проблемой встретились, добавляя слушателя.

См. Также:

removeNamingListener(javax.naming.event.NamingListener)

addNamingListener

void addNamingListener(String target,
                     int scope,
                     NamingListener l)
                       throws NamingException

Добавляет слушатель для того, чтобы получить события именования, запущенные, когда объект, названный строкой, предназначается для имени и изменений контекста. См. перегрузку, которая принимает Name для деталей.

Параметры:

target - Имя непустой строки объекта решало относительно этого контекста.

scope - Один из OBJECT_SCOPE, ONELEVEL_SCOPE, или SUBTREE_SCOPE.

l - Ненулевой слушатель.

Броски:

NamingException - Если с проблемой встретились, добавляя слушателя.

См. Также:

removeNamingListener(javax.naming.event.NamingListener)

removeNamingListener

void removeNamingListener(NamingListener l)
                          throws NamingException

Удаляет слушателя из получения событий именования, запущенных этим EventContext. Слушатель, возможно, зарегистрировался не раз в этом EventContext, возможно в различных параметрах цели/контекста. После того, как этот метод вызывается, слушатель больше не будет получать события с этим экземпляром EventContext как источник события (за исключением тех событий уже в процессе того, чтобы быть диспетчеризированным). Если слушатель не был, или больше не, зарегистрирован в этом экземпляре EventContext, этот метод ничего не делает.

Параметры:

l - Ненулевой слушатель.

Броски:

NamingException - Если с проблемой встретились, удаляя слушателя.

См. Также:

addNamingListener(javax.naming.Name, int, javax.naming.event.NamingListener)

targetMustExist

boolean targetMustExist()
                        throws NamingException

Определяет, может ли слушатель зарегистрировать интерес к цели, которая не существует.

Возвраты:

истина, если цель должна существовать; ложь, если целевая потребность не существует.

Броски:

NamingException - Если поведение контекста в этом отношении не может быть определено.