模块 java.naming

Package javax.naming.directory

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

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

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

目录上下文

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

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

DirContext也可以通过扩展javax.naming软件包中的Context接口来充当命名上下文。 这意味着任何目录对象也可以提供命名上下文。 例如，某人的目录对象可能包含该人的属性，同时提供相对于该人命名对象的上下文，例如他的打印机和主目录。

搜索

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

包装规格

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

从以下版本开始：

1.3

接口摘要

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

类摘要

类	描述
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.