Интерфейс EventDirContext

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

public interface EventDirContext extends EventContext, DirContext

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

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

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

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

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

Начиная с версии:: 1.3

Краткое описание полей

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

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

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

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

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

OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE

Краткое описание методов

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

Методы, объявленные в интерфейсе 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

Методы, объявленные в интерфейсе 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

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

addNamingListener, addNamingListener, removeNamingListener, targetMustExist

Подробное описание методов

addNamingListener

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

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

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

Параметры:

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

filter — Ненулевая строка фильтра (см. RFC2254).

ctls — Параметры поиска, которые могут быть null. Если значение равно null, используются параметры поиска по умолчанию.

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

Исключения:

NamingException — Если при добавлении слушателя возникла проблема.

См. также:

addNamingListener

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

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

Параметры:

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

filter — Ненулевая строка фильтра (см. RFC2254).

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

Исключения:

NamingException — Если при добавлении слушателя возникла проблема.

См. также:

addNamingListener

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

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

Параметры:

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

filter — Ненулевая строка фильтра (см. RFC2254).

filterArgs — Массив аргументов фильтра, который может быть null.

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

Исключения:

NamingException — Если при добавлении слушателя возникла проблема.

См. также:

addNamingListener

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

Параметры:

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

filter — Ненулевая строка фильтра (см. RFC2254).

filterArgs — Массив аргументов фильтра, который может быть null.

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

Исключения:

NamingException — Если при добавлении слушателя возникла проблема.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/event/EventDirContext.html