Пакет javax.naming.directory

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

См.: Описание

Интерфейсная Сводка

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

Сводка класса

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

Сводка исключения

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

Пакет javax.naming.directory Описание

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

Этот пакет определяет операции каталога Именования Java и Каталога ^InterfaceTM (JNDI). JNDI обеспечивает именование и функциональность каталога к приложениям, записанным в языке программирования Java. Это разрабатывается, чтобы быть независимым от любого определенного именования или реализации службы каталогов. Таким образом ко множеству служб - новый, появление, и уже развернутые - можно получить доступ в распространенном способе.

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

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

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

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

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

Поиски

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

Спецификация пакета

Спецификация API JNDI и связанные документы могут быть найдены в документации JNDI.

С тех пор:

1.3