Интерфейс 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 в объекте с именем target.

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

Параметры:

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

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

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

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

Исключения:

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

См. также:

addNamingListener

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

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

Параметры:

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

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

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

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 - Возможно, нулевой массив аргументов для фильтра.

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

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

Исключения:

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

См. также:

addNamingListener

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

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

Parameters:

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

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

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

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

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

Throws:

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

See Also:

© 1993, 2021, 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/17/docs/api/java.naming/javax/naming/event/EventDirContext.html