Пакет javax.naming.directory
Расширяет пакет javax.naming для предоставления функциональности доступа к службам каталогов.
См.: Описание
| Интерфейс | Описание |
|---|---|
| Attribute | Этот интерфейс представляет атрибут, связанный с именованным объектом. |
| Attributes | Этот интерфейс представляет коллекцию атрибутов. |
| DirContext | Интерфейс службы каталогов, содержащий методы для проверки и обновления атрибутов, связанных с объектами, и для поиска в каталоге. |
| Класс | Описание |
|---|---|
| BasicAttribute | Этот класс предоставляет базовую реализацию интерфейса |
| BasicAttributes | Этот класс предоставляет базовую реализацию интерфейса Attributes. |
| InitialDirContext | Этот класс является начальным контекстом для выполнения операций с каталогом. |
| ModificationItem | Этот класс представляет элемент изменения. |
| SearchControls | Этот класс инкапсулирует факторы, определяющие область поиска и то, что возвращается в результате поиска. |
| SearchResult | Этот класс представляет элемент в NamingEnumeration, возвращаемый в результате методов DirContext.search(). |
| Исключение | Описание |
|---|---|
| AttributeInUseException | Это исключение возникает, когда операция пытается добавить атрибут, который уже существует. |
| AttributeModificationException | Это исключение возникает, когда происходит попытка добавить, удалить или изменить атрибут, его идентификатор или его значения, что противоречит определению атрибута (схеме) или состоянию атрибута. |
| InvalidAttributeIdentifierException | Это исключение возникает, когда делается попытка добавить или создать атрибут с некорректным идентификатором атрибута. |
| InvalidAttributesException | Это исключение возникает, когда делается попытка добавить или изменить набор атрибутов, который указан неполно или неправильно. |
| InvalidAttributeValueException | Этот класс выбрасывается, когда делается попытка добавить в атрибут значение, которое конфликтует с определением схемы атрибута. |
| InvalidSearchControlsException | Это исключение возникает, когда указание SearchControls для операции поиска некорректно. |
| InvalidSearchFilterException | Это исключение возникает, когда указание фильтра поиска некорректно. |
| NoSuchAttributeException | Это исключение возникает при попытке доступа к атрибуту, которого не существует. |
| SchemaViolationException | Это исключение возникает, когда метод каким-либо образом нарушает схему. |
Описание пакета javax.naming.directory
Расширяет пакет javax.naming для предоставления функциональности доступа к службам каталогов.
Этот пакет определяет операции каталога Java Naming and Directory InterfaceTM (JNDI). JNDI предоставляет приложениям, написанным на языке программирования Java, функциональность именования и каталогов. Он разработан для независимости от любой конкретной реализации службы именования или каталогов. Таким образом, к различным службам — новым, появляющимся и уже развернутым — можно получить доступ стандартным способом.
Этот пакет позволяет приложениям извлекать и обновлять атрибуты, связанные с объектами, хранящимися в каталоге, и выполнять поиск объектов с использованием указанных атрибутов.
Контекст каталога
ИнтерфейсDirContext представляет собой контекст каталога. Он определяет методы для проверки и обновления атрибутов, связанных с объектом каталога, или записью каталога, как его иногда называют. Для получения атрибутов, связанных с объектом каталога (для которого вы предоставляете имя), используйте getAttributes(). Атрибуты изменяются с помощью modifyAttributes(). Вы можете добавлять, заменять или удалять атрибуты и/или значения атрибутов с помощью этой операции.
DirContext также ведет себя как контекст именования, расширяя интерфейс Context в пакете javax.naming. Это означает, что любой объект каталога также может обеспечить контекст именования. Например, объект каталога для человека может содержать атрибуты этого человека и одновременно обеспечивать контекст для именования объектов, относящихся к этому человеку, таких как его принтеры и домашний каталог.
Поиск
DirContext содержит методы для выполнения поиска по содержанию каталога. В простейшей и наиболее распространенной форме использования приложение указывает набор атрибутов — возможно, со специфическими значениями — для сопоставления и отправляет этот набор атрибутов методу search(). Существуют и другие перегруженные формы search(), которые поддерживают более сложные фильтры поиска.- С:
- 1.3
© 1993, 2020, 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.
