Module java.naming

Package javax.naming.directory

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

该包定义了Java命名和目录接口（JNDI）的目录操作。 JNDI为以Java编程语言编写的应用程序提供命名和目录功能。 它被设计为独立于任何特定的命名或目录服务实现。 因此，可以以一种常见的方式访问各种服务 - 新的，新兴的和已经部署的服务。

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

目录上下文

DirContext接口代表一个目录上下文 。 它定义了用于检查和更新与目录对象或目录条目相关联的属性的方法，因为它有时被称为。

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

DirContext还通过在javax.naming程序包中扩展Context接口来表现为命名上下文。 这意味着任何目录对象也可以提供命名上下文。 例如，一个人的目录对象可能包含该人的属性，同时提供一个上下文来命名对象相对于该人，比如他的打印机和主目录。

搜索

DirContext包含用于执行目录的基于内容的搜索的方法。 在最简单和最常见的使用形式中，应用程序指定一组属性（可能具有特定值），以匹配并将此属性集提交到search()方法。 还有search()其他重载形式支持更复杂的搜索过滤器 。

包装规格

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

从以下版本开始：

1.3

接口摘要

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

类摘要

Class	描述
BasicAttribute	该类提供了 Attribute接口的基本实现。
BasicAttributes	该类提供了Attributes界面的基本实现。
InitialDirContext	此类是执行目录操作的起始上下文。
ModificationItem	此类表示修改项。
SearchControls	该类封装了确定搜索范围和搜索结果返回的因素。
SearchResult	该类表示由DirContext.search（）方法返回的NamingEnumeration中的一个项目。

异常摘要

异常	描述
AttributeInUseException	当操作尝试添加已经存在的属性时，抛出此异常。
AttributeModificationException	当尝试添加，删除或修改与属性（模式）定义或属性状态相冲突的属性，其标识符或其值时，将抛出此异常。
InvalidAttributeIdentifierException	当尝试添加以创建具有无效属性标识符的属性时，会抛出此异常。
InvalidAttributesException	尝试添加或修改不完整或不正确指定的属性集时，会抛出此异常。
InvalidAttributeValueException	当尝试向属性添加与属性的模式定义冲突的值时，将抛出此类。
InvalidSearchControlsException	当搜索操作的SearchControls的规范无效时，抛出此异常。
InvalidSearchFilterException	当搜索过滤器的规范无效时抛出此异常。
NoSuchAttributeException	尝试访问不存在的属性时抛出此异常。
SchemaViolationException	This exception is thrown when a method in some ways violates the schema.