Пакет 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, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/directory/package-summary.html
