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