软件包 javax.naming.directory

扩展 javax.naming 包以提供访问目录服务的功能。

请参见：
描述

接口摘要

Attribute	此接口表示与命名对象关联的属性。
Attributes	此接口表示属性的集合。
DirContext	目录服务接口，包含一些用于检查和更新与对象关联的属性以及搜索目录的方法。

类摘要

BasicAttribute	此类提供 Attribute 接口的基本实现。
BasicAttributes	此类提供 Attributes 接口的基本实现。
InitialDirContext	此类是执行目录操作的初始上下文。
ModificationItem	此类表示修改项。
SearchControls	此类封装确定搜索范围和搜索返回结果的因子。
SearchResult	此类表示作为 DirContext.search() 方法的结果返回的 NamingEnumeration 中的一项。

异常摘要

AttributeInUseException	当操作试图添加已经存在的属性时抛出此异常。
AttributeModificationException	当试图添加、移除或修改与属性的（模式）定义或属性的状态有冲突的属性、属性标识符或属性值时抛出此异常。
InvalidAttributeIdentifierException	在试图用无效的属性标识符创建属性时，抛出此异常。
InvalidAttributesException	在尝试添加或修改不完全或不正确地指定的属性集时，抛出此异常。
InvalidAttributeValueException	在尝试添加一个与属性的模式定义有冲突的属性时，抛出此类。
InvalidSearchControlsException	在为搜索操作指定的 SearchControls 无效时，抛出此异常。
InvalidSearchFilterException	当指定的搜索过滤器无效时，抛出此异常。
NoSuchAttributeException	尝试访问不存在的属性时，抛出此异常。
SchemaViolationException	当方法在某些方面违反模式时，抛出此异常。

软件包 javax.naming.directory 的描述

扩展 javax.naming 包以提供访问目录服务的功能。

此包定义 Java Naming and Directory Interface^TM (JNDI) 的目录操作。 JNDI 向使用 Java 编程语言编写的应用程序提供命名和目录功能。它被设计成与任何特定的命名或目录服务实现无关。因此可以使用共同的方式对多种服务（新的、新出现的及已经部署的服务）进行访问。

此包允许应用程序检索和更新与存储在目录中的对象关联的属性，以及使用指定属性搜索对象。

目录上下文

DirContext 接口表示 目录上下文。该接口定义了一些方法来检验和更新与 目录对象（有时称为 目录项）关联的属性。

可以使用 getAttributes() 检索与目录对象（为其提供名称）关联的属性。使用 modifyAttributes() 修改属性。使用此操作可以添加、替换或移除属性和/或属性值。

通过扩展 javax.naming 包中的 Context 接口，DirContext 还可以用作命名上下文。这意味着所有目录对象也都可以提供命名上下文。例如，某个人的目录对象可能包含该人的属性，同时提供与该人相关的命名对象（如他的打印机和住宅目录）的上下文。

搜索

DirContext 包含一些对目录执行基于内容的搜索的方法。最简单和最普通的用法是，应用程序指定一属性集（可能带有特定值）来匹配 search() 方法，并将此属性集提交给该方法。也有其他重载形式的 search()，可支持更复杂的 搜索过滤器。

包规范

JNDI API 规范及相关文档可在 JNDI documentation 中找到。

从以下版本开始：

1.3