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

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

Параметры:

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

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

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

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

Исключения:

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

См. также:

addNamingListener

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

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

Параметры:

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

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

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

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

Исключения:

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

См. также:

addNamingListener

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

Добавляет слушателя для получения событий именования, генерируемых при изменении объектов, идентифицированных фильтром поиска filter и аргументами фильтра в объекте, именованном целевым объектом. Диапазон, флаг возврата объекта и флаг возврата атрибутов из параметров поиска 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 для получения подробной информации о поведении этого метода.

Параметры:

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

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

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

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

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

Исключения:

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

См. также:

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