Пакет javax.naming.directory
javax.naming, предоставляя функциональность для доступа к службам каталогов. Этот пакет определяет операции с каталогами интерфейса именования и каталогов Java (JNDI). JNDI предоставляет приложениям, написанным на языке программирования Java, функциональность именования и работы с каталогами. Он разработан независимо от каких-либо конкретных реализаций служб именования или каталогов. Таким образом, к различным службам — новым, появляющимся и уже развернутым — можно обращаться единообразным способом.
Этот пакет позволяет приложениям извлекать и обновлять атрибуты, связанные с объектами, хранящимися в каталоге, а также выполнять поиск объектов по заданным атрибутам.
Контекст каталога
ИнтерфейсDirContext представляет контекст каталога. Он определяет методы для просмотра и обновления атрибутов, связанных с объектом каталога, также называемым записью каталога. С помощью getAttributes() можно получить атрибуты, связанные с объектом каталога (указав его имя). Атрибуты изменяются с помощью modifyAttributes(). Эта операция позволяет добавлять, заменять или удалять атрибуты и/или значения атрибутов.
DirContext также ведет себя как контекст именования, поскольку расширяет интерфейс Context из пакета javax.naming. Это означает, что любой объект каталога может также предоставлять контекст именования. Например, объект каталога, представляющий человека, может содержать атрибуты этого человека и одновременно предоставлять контекст для именования объектов относительно этого человека, таких как его принтеры и домашний каталог.
Поиск
DirContext содержит методы для выполнения поиска в каталоге по содержимому. В наиболее простом и распространенном случае приложение задает набор атрибутов — возможно, с конкретными значениями — для сопоставления и передает этот набор атрибутов методу search(). Существуют и другие перегруженные формы search(), поддерживающие более сложные фильтры поиска. Спецификация пакета
Спецификацию API JNDI и связанные с ней документы можно найти в документации JNDI.- Начиная с:
- 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://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/directory/package-summary.html
