Module java.naming
Package javax.naming.directory
package javax.naming.directory
扩展了
javax.naming包，提供了访问目录服务的功能。
该包定义了Java命名和目录接口（JNDI）的目录操作。 JNDI为使用Java编程语言编写的应用程序提供命名和目录功能。它被设计为独立于任何特定的命名或目录服务实现。因此，各种服务--新的、新兴的和已部署的服务--可以以通用的方式访问。
该包允许应用程序检索和更新存储在目录中的对象关联的属性，并使用指定的属性搜索对象。
目录上下文
DirContext接口表示一个目录上下文。它定义了用于检查和更新与目录对象或有时称为目录条目相关联的属性的方法。
您可以使用getAttributes()检索与目录对象关联的属性（您提供名称）。使用modifyAttributes()修改属性。您可以使用此操作添加、替换或删除属性和/或属性值。
DirContext还通过扩展javax.naming包中的Context接口充当命名上下文。这意味着任何目录对象也可以提供命名上下文。例如，一个人的目录对象可能包含该人的属性，并同时为相对于该人的对象提供命名上下文，如他的打印机和主目录。
搜索
DirContext包含执行基于内容的目录搜索的方法。在最简单和最常见的用法中，应用程序指定一组属性--可能具有特定值--进行匹配，并将此属性集提交给search()方法。还有其他重载形式的search()支持更复杂的搜索过滤器。
包规范
JNDI API规范和相关文档可以在JNDI文档中找到。- 自版本:
- 1.3
-
ClassDescription该接口表示与命名对象关联的属性。当操作尝试添加已存在的属性时抛出此异常。当尝试添加、删除或修改与属性（模式）定义或属性状态冲突的属性、其标识符或其值时抛出此异常。该接口表示属性的集合。该类提供了
Attribute接口的基本实现。该类提供了Attributes接口的基本实现。目录服务接口，包含用于检查和更新与对象关联的属性以及搜索目录的方法。该类是执行目录操作的起始上下文。当尝试使用无效的属性标识符创建属性时抛出此异常。当尝试添加或修改已指定不完整或不正确的属性集时抛出此异常。当尝试向属性添加与属性模式定义冲突的值时抛出此异常。当搜索操作的SearchControls规范无效时抛出此异常。当搜索过滤器的规范无效时抛出此异常。该类表示修改项。当尝试访问不存在的属性时抛出此异常。当某种方式的方法违反模式时抛出此异常。该类封装了确定搜索范围和搜索结果的因素。该类表示DirContext.search()方法返回的NamingEnumeration中的项。