请参见:
描述
接口摘要 | |
---|---|
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 包以提供访问目录服务的功能。
此包定义 Java Naming and Directory InterfaceTM (JNDI) 的目录操作。 JNDI 向使用 Java 编程语言编写的应用程序提供命名和目录功能。它被设计成与任何特定的命名或目录服务实现无关。因此可以使用共同的方式对多种服务(新的、新出现的及已经部署的服务)进行访问。
此包允许应用程序检索和更新与存储在目录中的对象关联的属性,以及使用指定属性搜索对象。
可以使用 getAttributes() 检索与目录对象(为其提供名称)关联的属性。使用 modifyAttributes() 修改属性。使用此操作可以添加、替换或移除属性和/或属性值。
通过扩展 javax.naming 包中的 Context 接口,DirContext 还可以用作命名上下文。这意味着所有目录对象也都可以提供命名上下文。例如,某个人的目录对象可能包含该人的属性,同时提供与该人相关的命名对象(如他的打印机和住宅目录)的上下文。