软件包 javax.naming.directory 的描述

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

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

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

目录上下文

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

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

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

搜索

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

包规范

以下文档可以在 Java 技术站点找到：

JNDI API Document (Postscript)

JNDI API Document (PDF)

相关文档

有关教程、示例和概述，请参阅：

The JNDI Tutorial

Examples

Executive Summary (Postscript)

Executive Summary (PDF)

从以下版本开始：

1.3