Интерфейс 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

Модификатор и тип	Поле	Описание
`static final String`	`AUTHORITATIVE`	Константа, содержащая имя свойства среды для указания степени авторитетности запрашиваемой службы.
`static final String`	`BATCHSIZE`	Константа, содержащая имя свойства среды для указания размера пакета данных при возврате данных через протокол службы.
`static final String`	`DNS_URL`	Константа, содержащая имя свойства среды для указания имени DNS-хоста и домена, используемых для контекста URL JNDI (например, "dns://somehost/wiz.com").
`static final String`	`INITIAL_CONTEXT_FACTORY`	Константа, содержащая имя свойства среды для указания используемой фабрики начального контекста.
`static final String`	`LANGUAGE`	Константа, содержащая имя свойства среды для указания предпочтительного языка, используемого службой.
`static final String`	`OBJECT_FACTORIES`	Константа, содержащая имя свойства среды для указания списка используемых фабрик объектов.
`static final String`	`PROVIDER_URL`	Константа, содержащая имя свойства среды для указания конфигурационных данных, используемых поставщиком службы.
`static final String`	`REFERRAL`	Константа, содержащая имя свойства среды для указания способа обработки перенаправлений, обнаруженных поставщиком службы.
`static final String`	`SECURITY_AUTHENTICATION`	Константа, содержащая имя свойства среды для указания используемого уровня безопасности.
`static final String`	`SECURITY_CREDENTIALS`	Константа, содержащая имя свойства среды для указания учетных данных субъекта, используемых для аутентификации вызывающей стороны в службе.
`static final String`	`SECURITY_PRINCIPAL`	Константа, содержащая имя свойства среды для указания идентификатора субъекта, используемого для аутентификации вызывающей стороны в службе.
`static final String`	`SECURITY_PROTOCOL`	Константа, содержащая имя свойства среды для указания используемого протокола безопасности.
`static final String`	`STATE_FACTORIES`	Константа, содержащая имя свойства среды для указания списка используемых фабрик состояний.
`static final String`	`URL_PKG_PREFIXES`	Константа, содержащая имя свойства среды для указания списка префиксов пакетов, используемых при загрузке фабрик контекстов URL.

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

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

Модификатор и тип	Поле	Описание
`static final int`	`ADD_ATTRIBUTE`	Эта константа указывает на добавление атрибута с указанными значениями.
`static final int`	`REMOVE_ATTRIBUTE`	Эта константа указывает на удаление указанных значений атрибута из атрибута.
`static final int`	`REPLACE_ATTRIBUTE`	Эта константа указывает на замену атрибута указанными значениями.

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

OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE

Модификатор и тип	Поле	Описание
`static final int`	`OBJECT_SCOPE`	Константа для выражения интереса к событиям, касающимся объекта, указанного целевым объектом.
`static final int`	`ONELEVEL_SCOPE`	Константа для выражения интереса к событиям, касающимся объектов в контексте, указанном целевым объектом, за исключением самого указанного контекста.
`static final int`	`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.

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

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

Модификатор и тип	Метод	Описание
`Object`	`addToEnvironment(String propName, Object propVal)`	Добавляет новое свойство среды в среду этого контекста.
`void`	`bind(String name, Object obj)`	Связывает имя с объектом.
`void`	`bind(Name name, Object obj)`	Связывает имя с объектом.
`void`	`close()`	Закрывает этот контекст.
`String`	`composeName(String name, String prefix)`	Объединяет имя этого контекста с именем, относительным к этому контексту.
`Name`	`composeName(Name name, Name prefix)`	Объединяет имя этого контекста с именем, относительным к этому контексту.
`Context`	`createSubcontext(String name)`	Создает и связывает новый контекст.
`Context`	`createSubcontext(Name name)`	Создает и связывает новый контекст.
`void`	`destroySubcontext(String name)`	Уничтожает именованный контекст и удаляет его из пространства имен.
`void`	`destroySubcontext(Name name)`	Уничтожает именованный контекст и удаляет его из пространства имен.
`Hashtable<?,?>`	`getEnvironment()`	Возвращает среду, действующую для этого контекста.
`String`	`getNameInNamespace()`	Возвращает полное имя этого контекста в его собственном пространстве имен.
`NameParser`	`getNameParser(String name)`	Возвращает анализатор, связанный с именованным контекстом.
`NameParser`	`getNameParser(Name name)`	Возвращает анализатор, связанный с именованным контекстом.
`NamingEnumeration<NameClassPair>`	`list(String name)`	Перечисляет имена, связанные в именованном контексте, а также имена классов связанных с ними объектов.
`NamingEnumeration<NameClassPair>`	`list(Name name)`	Перечисляет имена, связанные в именованном контексте, а также имена классов связанных с ними объектов.
`NamingEnumeration<Binding>`	`listBindings(String name)`	Перечисляет имена, связанные в именованном контексте, а также связанные с ними объекты.
`NamingEnumeration<Binding>`	`listBindings(Name name)`	Перечисляет имена, связанные в именованном контексте, а также связанные с ними объекты.
`Object`	`lookup(String name)`	Возвращает именованный объект.
`Object`	`lookup(Name name)`	Возвращает именованный объект.
`Object`	`lookupLink(String name)`	Возвращает именованный объект, следуя по ссылкам, за исключением конечного атомарного компонента имени.
`Object`	`lookupLink(Name name)`	Возвращает именованный объект, следуя по ссылкам, за исключением конечного атомарного компонента имени.
`void`	`rebind(String name, Object obj)`	Связывает имя с объектом, заменяя любую существующую привязку.
`void`	`rebind(Name name, Object obj)`	Связывает имя с объектом, заменяя любую существующую привязку.
`Object`	`removeFromEnvironment(String propName)`	Удаляет свойство среды из среды этого контекста.
`void`	`rename(String oldName, String newName)`	Связывает новое имя с объектом, связанным со старым именем, и отменяет привязку старого имени.
`void`	`rename(Name oldName, Name newName)`	Связывает новое имя с объектом, связанным со старым именем, и отменяет привязку старого имени.
`void`	`unbind(String name)`	Отменяет привязку именованного объекта.
`void`	`unbind(Name name)`	Отменяет привязку именованного объекта.

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

Модификатор и тип	Метод	Описание
`void`	`bind(String name, Object obj, Attributes attrs)`	Связывает имя с объектом и соответствующими атрибутами.
`void`	`bind(Name name, Object obj, Attributes attrs)`	Связывает имя с объектом и соответствующими атрибутами.
`DirContext`	`createSubcontext(String name, Attributes attrs)`	Создает и связывает новый контекст с соответствующими атрибутами.
`DirContext`	`createSubcontext(Name name, Attributes attrs)`	Создает и связывает новый контекст с соответствующими атрибутами.
`Attributes`	`getAttributes(String name)`	Возвращает все атрибуты, связанные с именованным объектом.
`Attributes`	`getAttributes(String name, String[] attrIds)`	Возвращает выбранные атрибуты, связанные с именованным объектом.
`Attributes`	`getAttributes(Name name)`	Возвращает все атрибуты, связанные с именованным объектом.
`Attributes`	`getAttributes(Name name, String[] attrIds)`	Возвращает выбранные атрибуты, связанные с именованным объектом.
`DirContext`	`getSchema(String name)`	Возвращает схему, связанную с именованным объектом.
`DirContext`	`getSchema(Name name)`	Возвращает схему, связанную с именованным объектом.
`DirContext`	`getSchemaClassDefinition(String name)`	Возвращает контекст, содержащий объекты схемы для определений классов именованного объекта.
`DirContext`	`getSchemaClassDefinition(Name name)`	Возвращает контекст, содержащий объекты схемы для определений классов именованного объекта.
`void`	`modifyAttributes(String name, int mod_op, Attributes attrs)`	Изменяет атрибуты, связанные с именованным объектом.
`void`	`modifyAttributes(String name, ModificationItem[] mods)`	Изменяет атрибуты, связанные с именованным объектом, используя упорядоченный список изменений.
`void`	`modifyAttributes(Name name, int mod_op, Attributes attrs)`	Изменяет атрибуты, связанные с именованным объектом.
`void`	`modifyAttributes(Name name, ModificationItem[] mods)`	Изменяет атрибуты, связанные с именованным объектом, используя упорядоченный список изменений.
`void`	`rebind(String name, Object obj, Attributes attrs)`	Связывает имя с объектом и соответствующими атрибутами, заменяя любую существующую привязку.
`void`	`rebind(Name name, Object obj, Attributes attrs)`	Связывает имя с объектом и соответствующими атрибутами, заменяя любую существующую привязку.
`NamingEnumeration<SearchResult>`	`search(String name, String filterExpr, Object[] filterArgs, SearchControls cons)`	Выполняет поиск в именованном контексте или объекте записей, удовлетворяющих заданному фильтру поиска.
`NamingEnumeration<SearchResult>`	`search(String name, String filter, SearchControls cons)`	Выполняет поиск в именованном контексте или объекте записей, удовлетворяющих заданному фильтру поиска.
`NamingEnumeration<SearchResult>`	`search(String name, Attributes matchingAttributes)`	Выполняет поиск в одном контексте объектов, содержащих заданный набор атрибутов.
`NamingEnumeration<SearchResult>`	`search(String name, Attributes matchingAttributes, String[] attributesToReturn)`	Выполняет поиск в одном контексте объектов, содержащих заданный набор атрибутов, и возвращает выбранные атрибуты.
`NamingEnumeration<SearchResult>`	`search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons)`	Выполняет поиск в именованном контексте или объекте записей, удовлетворяющих заданному фильтру поиска.
`NamingEnumeration<SearchResult>`	`search(Name name, String filter, SearchControls cons)`	Выполняет поиск в именованном контексте или объекте записей, удовлетворяющих заданному фильтру поиска.
`NamingEnumeration<SearchResult>`	`search(Name name, Attributes matchingAttributes)`	Выполняет поиск в одном контексте объектов, содержащих заданный набор атрибутов.
`NamingEnumeration<SearchResult>`	`search(Name name, Attributes matchingAttributes, String[] attributesToReturn)`	Выполняет поиск в одном контексте объектов, содержащих заданный набор атрибутов, и возвращает выбранные атрибуты.

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

addNamingListener, addNamingListener, removeNamingListener, targetMustExist

Модификатор и тип	Метод	Описание
`void`	`addNamingListener(String target, int scope, NamingListener l)`	Добавляет слушателя для получения событий именования, генерируемых при изменении объекта, имя которого указано строкой target name, и области действия.
`void`	`addNamingListener(Name target, int scope, NamingListener l)`	Добавляет слушателя для получения событий именования, генерируемых при изменении объектов, определяемых target и областью действия.
`void`	`removeNamingListener(NamingListener l)`	Удаляет слушателя, чтобы он больше не получал события именования, генерируемые этим `EventContext`.
`boolean`	`targetMustExist()`	Определяет, может ли слушатель зарегистрировать интерес к несуществующему target.

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

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. Подробное описание работы этого метода см. в перегруженной версии, принимающей 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 — возможно, нулевой массив аргументов фильтра.

l — ненулевой прослушиватель.

Исключения:

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

См. также:

addNamingListener

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

Параметры:

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

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

filterArgs — возможно, нулевой массив аргументов фильтра.

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.