JavaTM 2 Platform
Standard Ed. 6

软件包 javax.naming.directory

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

请参见:
          描述

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

类摘要
BasicAttribute 此类提供 Attribute 接口的基本实现。
BasicAttributes 此类提供 Attributes 接口的基本实现。
InitialDirContext 此类是执行目录操作的初始上下文。
ModificationItem 此类表示修改项。
SearchControls 此类封装确定搜索范围和搜索返回结果的因子。
SearchResult 此类表示作为 DirContext.search() 方法的结果返回的 NamingEnumeration 中的一项。
 

异常摘要
AttributeInUseException 当操作试图添加已经存在的属性时抛出此异常。
AttributeModificationException 当试图添加、移除或修改与属性的(模式)定义或属性的状态有冲突的属性、属性标识符或属性值时抛出此异常。
InvalidAttributeIdentifierException 在试图用无效的属性标识符创建属性时,抛出此异常。
InvalidAttributesException 在尝试添加或修改不完全或不正确地指定的属性集时,抛出此异常。
InvalidAttributeValueException 在尝试添加一个与属性的模式定义有冲突的属性时,抛出此类。
InvalidSearchControlsException 在为搜索操作指定的 SearchControls 无效时,抛出此异常。
InvalidSearchFilterException 当指定的搜索过滤器无效时,抛出此异常。
NoSuchAttributeException 尝试访问不存在的属性时,抛出此异常。
SchemaViolationException 当方法在某些方面违反模式时,抛出此异常。
 

软件包 javax.naming.directory 的描述

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

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

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

目录上下文

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

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

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

搜索

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

包规范

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

从以下版本开始:
1.3

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策