Интерфейс EventDirContext

Все суперинтерфейсы:: Context, DirContext, EventContext

public interface EventDirContext
extends EventContext, DirContext

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

Методы в этом интерфейсе поддерживают идентификацию объектов по фильтрам поиска RFC 2254.

Используя фильтр поиска, можно зарегистрировать интерес к объектам, которые не существуют на момент регистрации, но позже появляются и удовлетворяют фильтру. Однако могут быть ограничения в том, насколько это поддерживается поставщиком сервиса и базовым протоколом/сервисом. Если вызывающий код предоставляет фильтр, который не может быть обработан таким образом, addNamingListener() выбрасывает InvalidSearchFilterException.

См. EventContext для описания источника и цели события, а также информации о регистрации/удалении слушателей, которые также применимы к методам в этом интерфейсе. См. описание пакета для информации о проблемах с потоками.

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

С момента:: 1.3

Поля

Поля, объявленные в интерфейсе javax.naming.Context

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

Поля, объявленные в интерфейсе javax.naming.directory.DirContext

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

Поля, объявленные в интерфейсе javax.naming.event.EventContext

OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE

Методы

Модификатор и тип	Метод	Описание
`void`	`addNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)`	Добавляет слушателя для получения событий об именовании, срабатывающих при изменении объектов, идентифицируемых фильтром поиска `filter` и аргументами фильтра в объекте, именованном строкой имени цели.
`void`	`addNamingListener(String target, String filter, SearchControls ctls, NamingListener l)`	Добавляет слушателя для получения событий об именовании, срабатывающих при изменении объектов, идентифицируемых фильтром поиска `filter` в объекте, именованном строкой имени цели.
`void`	`addNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)`	Добавляет слушателя для получения событий об именовании, срабатывающих при изменении объектов, идентифицируемых фильтром поиска `filter` и аргументами фильтра в объекте, именованном целевым именем.
`void`	`addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l)`	Добавляет слушателя для получения событий об именовании, срабатывающих при изменении объектов, идентифицируемых фильтром поиска `filter` в объекте, именованном целевым именем.

Методы, объявленные в интерфейсе javax.naming.Context

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

Методы, объявленные в интерфейсе javax.naming.directory.DirContext

bind, bind, createSubcontext, createSubcontext, getAttributes, getAttributes, getAttributes, getAttributes, getSchema, getSchema, getSchemaClassDefinition, getSchemaClassDefinition, modifyAttributes, modifyAttributes, modifyAttributes, modifyAttributes, rebind, rebind, search, search, search, search, search, search, search, search

Методы, объявленные в интерфейсе javax.naming.event.EventContext

addNamingListener, addNamingListener, removeNamingListener, targetMustExist

Методы

addNamingListener

void addNamingListener(Name target,
                       String filter,
                       SearchControls ctls,
                       NamingListener l)
                throws NamingException

Добавляет слушателя для получения событий об именовании, срабатывающих при изменении объектов, идентифицируемых фильтром поиска filter в объекте, именованном целевым именем.

Диапазон, флаг returningObj и флаг returningAttributes из параметров поиска ctls используются для управления выбором объектов, к которым проявляет интерес слушатель, и определяет, какая информация возвращается в конечном NamingEvent объекте. Обратите внимание, что запрошенная информация, которая должна быть возвращена, может отсутствовать в NamingEvent объекте, если она недоступна или не может быть получена поставщиком сервиса или самим сервисом.

Параметры:: target - Непустое имя объекта, разрешенного относительно данного контекста.; filter - Непустая строка фильтра (см. RFC2254).; ctls - Возможно null параметры поиска. Если null, используются значения по умолчанию.; l - Непустой слушатель.
Исключения:: NamingException - Если возникла проблема во время добавления слушателя.
См. также:: EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls)

addNamingListener

void addNamingListener(String target,
                       String filter,
                       SearchControls ctls,
                       NamingListener l)
                throws NamingException

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

Параметры:: target - Непустая строка имени объекта, разрешенного относительно данного контекста.; filter - Непустая строка фильтра (см. RFC2254).; ctls - Возможно null параметры поиска. Если null, используется значение по умолчанию.; l - Непустой слушатель.
Исключения:: NamingException - Если возникла проблема во время добавления слушателя.
См. также:: EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls)

addNamingListener

void addNamingListener(Name target,
                       String filter,
                       Object[] filterArgs,
                       SearchControls ctls,
                       NamingListener l)
                throws NamingException

Добавляет слушателя для получения событий об именовании, срабатывающих при изменении объектов, идентифицируемых фильтром поиска filter и аргументами фильтра в объекте, именованном целевым именем. Диапазон, флаг returningObj и флаг returningAttributes из параметров поиска ctls используются для управления выбором объектов, к которым проявляет интерес слушатель, и определяет, какая информация возвращается в конечном NamingEvent объекте. Обратите внимание, что запрошенная информация, которая должна быть возвращена, может отсутствовать в NamingEvent объекте, если она недоступна или не может быть получена поставщиком сервиса или самим сервисом.

Параметры:: target - Непустое имя объекта, разрешенного относительно данного контекста.; filter - Непустая строка фильтра (см. RFC2254).; filterArgs - Возможно null массив аргументов для фильтра.; ctls - Возможно null параметры поиска. Если null, используются значения по умолчанию.; l - Непустой слушатель.
Исключения:: NamingException - Если возникла проблема во время добавления слушателя.
См. также:: EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)

addNamingListener

void addNamingListener(String target,
                       String filter,
                       Object[] filterArgs,
                       SearchControls ctls,
                       NamingListener l)
                throws NamingException

Параметры:: target - Непустая строка имени объекта, разрешенного относительно данного контекста.; filter - Непустая строка фильтра (см. RFC2254).; filterArgs - Возможно null массив аргументов для фильтра.; ctls - Возможно null параметры поиска. Если null, используется значение по умолчанию.; l - Непустой слушатель.
Исключения:: NamingException - Если возникла проблема во время добавления слушателя.
См. также:: EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)