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