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