|
|||||||||
软件包 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()，可支持更复杂的搜索过滤器。包规范
以下文档可以在 Java 技术站点找到：相关文档
有关教程、示例和概述，请参阅：- 从以下版本开始：
- 1.3
所有类
|
|||||||||
