Пакет javax.naming.directory

Расширяет пакет javax.naming для предоставления функциональности доступа к службам каталогов.

Этот пакет определяет операции каталога в интерфейсе Java Naming and Directory Interface™ (JNDI). JNDI предоставляет приложениям, написанным на языке программирования Java, функциональность именования и каталогов. Он разработан таким образом, чтобы быть независимым от любой конкретной реализации службы именования или каталогов. Таким образом, к различным службам — новым, появляющимся и уже развернутым — можно получить доступ стандартным способом.

Этот пакет позволяет приложениям извлекать и обновлять атрибуты, связанные с объектами, хранящимися в каталоге, а также искать объекты с использованием указанных атрибутов.

Контекст каталога

Интерфейс DirContext представляет собой контекст каталога. Он определяет методы для проверки и обновления атрибутов, связанных с объектом каталога, или записью каталога, как это иногда называют.

Для извлечения атрибутов, связанных с объектом каталога (для которого вы предоставляете имя), используется getAttributes(). Атрибуты изменяются с помощью modifyAttributes(). С помощью этой операции можно добавлять, заменять или удалять атрибуты и/или значения атрибутов.

DirContext также функционирует как контекст именования, расширяя интерфейс Context в пакете javax.naming. Это означает, что любой объект каталога также может обеспечить контекст именования. Например, объект каталога для человека может содержать атрибуты этого человека и одновременно обеспечивать контекст для именования объектов, относящихся к этому человеку, таких как его принтеры и домашний каталог.

Поиск

DirContext содержит методы для выполнения поиска по содержимому каталога. В самом простом и наиболее распространенном варианте использования приложение указывает набор атрибутов — возможно, со специфическими значениями — для сопоставления и отправляет этот набор атрибутов методу search(). Существуют и другие перегруженные формы search(), которые поддерживают более сложные фильтры поиска.

С момента:: 1.3

Интерфейс	Описание
Атрибут	Этот интерфейс представляет атрибут, связанный с именованным объектом.
Атрибуты	Этот интерфейс представляет коллекцию атрибутов.
DirContext	Интерфейс службы каталогов, содержащий методы для проверки и обновления атрибутов, связанных с объектами, а также для поиска в каталоге.

Класс	Описание
BasicAttribute	Этот класс предоставляет базовую реализацию интерфейса `Attribute`.
BasicAttributes	Этот класс предоставляет базовую реализацию интерфейса Attributes.
InitialDirContext	Этот класс является исходным контекстом для выполнения операций с каталогом.
ModificationItem	Этот класс представляет собой элемент модификации.
SearchControls	Этот класс инкапсулирует факторы, определяющие область поиска и то, что возвращается в результате поиска.
SearchResult	Этот класс представляет собой элемент в NamingEnumeration, возвращаемый в результате методов DirContext.search().

Исключение	Описание
AttributeInUseException	Это исключение выбрасывается, когда операция пытается добавить атрибут, который уже существует.
AttributeModificationException	Это исключение выбрасывается, когда попытка добавить, удалить или изменить атрибут, его идентификатор или его значения конфликтует с определением атрибута (схемы) или состоянием атрибута.
InvalidAttributeIdentifierException	Это исключение выбрасывается, когда попытка добавить или создать атрибут с недопустимым идентификатором атрибута.
InvalidAttributesException	Это исключение выбрасывается, когда попытка добавить или изменить набор атрибутов была указана неполно или неправильно.
InvalidAttributeValueException	Этот класс выбрасывается, когда попытка добавить в атрибут значение, которое конфликтует с определением схемы атрибута.
InvalidSearchControlsException	Это исключение выбрасывается, когда указание SearchControls для операции поиска является недопустимым.
InvalidSearchFilterException	Это исключение выбрасывается, когда указание фильтра поиска является недопустимым.
NoSuchAttributeException	Это исключение выбрасывается при попытке доступа к атрибуту, которого не существует.
SchemaViolationException	Это исключение выбрасывается, когда метод каким-либо образом нарушает схему.