compact3

Package javax.naming.directory

延伸 javax.naming包用于访问目录服务提供的功能。

See: 描述

接口摘要

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

类摘要

类	描述
BasicAttribute	这个类提供了 Attribute接口的基本实现。
BasicAttributes	这个类提供了属性接口的基本实现。
InitialDirContext	此类是执行目录操作的起始上下文。
ModificationItem	这个类代表一个修改项目。
SearchControls	这类封装，确定搜索范围的因素，被作为搜索结果的返回。
SearchResult	这类代表一个项目的namingenumeration由于DirContext（）方法返回。

异常摘要

异常	描述
AttributeInUseException	当一个操作试图添加已存在的属性时，将引发此异常。
AttributeModificationException	当尝试添加、删除或修改属性、它的标识符或它的值与属性的（模式）定义或属性的状态发生冲突时，将引发此异常。
InvalidAttributeIdentifierException	当试图添加一个试图添加一个无效属性标识符的属性时，会引发此异常。
InvalidAttributesException	当试图添加或修改已指定不完全或不正确的属性集时，将引发此异常。
InvalidAttributeValueException	当试图添加一个属性，该属性与属性的架构定义冲突时，将引发此类。
InvalidSearchControlsException	抛出搜索操作的searchcontrols规格无效时这是例外。
InvalidSearchFilterException	当搜索筛选器的规范无效时，将引发此异常。
NoSuchAttributeException	当试图访问不存在的属性时，会引发此异常。
SchemaViolationException	当某些方法中的方法违反架构时，引发此异常。

Package javax.naming.directory Description

延伸到用于访问目录服务提供的功能的 javax.naming包。

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

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

目录上下文

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

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

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

搜索

DirContext包含用于执行基于目录的搜索方法。最简单和最常见的用法，应用程序指定一组属性，可能与特定的价值观相匹配，并提交该属性集，以 search()方法。有其他重载形式的 search()支持更复杂的搜索过滤器。

包装规格

JNDI API规范和相关文件，可以在 JNDI documentation发现。

从以下版本开始：

1.3