Интерфейс EventDirContext

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

public interface EventDirContext extends EventContext, DirContext

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

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

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

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

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

С:: 1.3

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

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

Поля, объявленные в интерфейсе 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` и аргументами фильтра в объекте, названном строкой 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.

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

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

Параметры:

target - Имя объекта, разрешенного относительно данного контекста (не null).

filter - Строковый фильтр (см. RFC2254) (не null).

ctls - Контроли поиска (возможно null). Если null, используются стандартные параметры.

l - Слушатель (не null).

Исключения:

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

См. также:

addNamingListener

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

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

Параметры:

target - Строковое имя объекта, разрешенного относительно данного контекста (не null).

filter - Строковый фильтр (см. RFC2254) (не null).

ctls - Контроли поиска (возможно null). Если null, используется стандартный набор параметров.

l - Слушатель (не null).

Исключения:

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

См. также:

addNamingListener

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

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

Параметры:

target - Имя объекта, разрешенного относительно данного контекста (не null).

filter - Строковый фильтр (см. RFC2254) (не null).

filterArgs - Массив аргументов для фильтра (возможно null).

ctls - Контроли поиска (возможно null). Если null, используются стандартные параметры.

l - Слушатель (не null).

Исключения:

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

См. также:

addNamingListener

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

Параметры:

target - Строковое имя объекта, разрешенного относительно данного контекста (не null).

filter - Строковый фильтр (см. RFC2254) (не null).

filterArgs - Массив аргументов для фильтра (возможно null).

ctls - Контроли поиска (возможно null). Если null, используется стандартный набор параметров.

l - Слушатель (не null).

Исключения:

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://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/event/EventDirContext.html