Attributes - [ Java参考文档 ] - 在线原生手册

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.naming.directory
接口 Attributes

所有超级接口：: Cloneable, Serializable

所有已知实现类：: BasicAttributes

public interface Attributes
extends Cloneable, Serializable

此接口表示属性的集合。

在目录中，命名的对象可以与其属性关联。Attributes 接口表示属性的集合。例如，可以从目录请求与对象关联的属性。这些属性在实现 Attributes 接口的对象中返回。

实现 Attributes 接口的对象中的属性是无序的。该对象可以有零个或多个属性。Attributes 或者区分大小写或者不区分大小写（忽略大小写）。此属性在创建 Attributes 对象时确定。（有关示例，请参阅 BasicAttributes 构造方法）。在不区分大小写的 Attributes 中，搜索属性或添加属性时将忽略其属性标识符的大小写。在区分大小写的 Attributes 中，大小写至关重要。

注意，更新 Attribute（如添加或移除属性）对目录中的相应表示形式没有影响。只有使用 DirContext 接口中的操作才能实现对目录的更新。

从以下版本开始：: 1.3
另请参见：: DirContext.getAttributes(javax.naming.Name), DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes), DirContext.bind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes), DirContext.rebind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes), DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes), DirContext.search(javax.naming.Name, javax.naming.directory.Attributes, java.lang.String[]), BasicAttributes

方法摘要
`Object`	`clone()` 对属性集进行复制。
`Attribute`	`get(String attrID)` 利用属性集中的给定属性 id 检索属性。
`NamingEnumeration<? extends Attribute>`	`getAll()` 检索属性集中属性的枚举。
`NamingEnumeration<String>`	`getIDs()` 检索属性集中属性的 id 的枚举。
`boolean`	`isCaseIgnored()` 确定在检索或添加属性时属性集是否忽略属性标识符的大小写。
`Attribute`	`put(Attribute attr)` 向属性集中添加新属性。
`Attribute`	`put(String attrID, Object val)` 向属性集中添加新属性。
`Attribute`	`remove(String attrID)` 从属性集中移除属性 id 为 'attrID' 的属性。
`int`	`size()` 在属性集中检索属性数。

方法详细信息

isCaseIgnored

boolean isCaseIgnored()

确定在检索或添加属性时属性集是否忽略属性标识符的大小写。

返回：: 如果忽略大小写，则返回 true；否则，返回 false。

size

int size()

在属性集中检索属性数。

返回：: 此属性集中的非负属性数。

get

Attribute get(String attrID)

利用属性集中的给定属性 id 检索属性。

参数：: attrID - 要检索的属性的非 null id。如果此属性集忽略其属性 id 的字符大小写，则忽略 attrID 的大小写。
返回：: 由 attrID 标识的属性；如果找不到，则返回 null。
另请参见：: put(java.lang.String, java.lang.Object), remove(java.lang.String)

getAll

NamingEnumeration<? extends Attribute> getAll()

检索属性集中属性的枚举。在此枚举上更新此属性集的结果是不确定的。

返回：: 此属性集中属性的非 null 枚举。每个枚举元素都属于 Attribute 类。如果属性集的属性数为零，则返回空枚举。

getIDs

NamingEnumeration<String> getIDs()

检索属性集中属性的 id 的枚举。在此枚举上更新此属性集的结果是不确定的。

返回：: 此属性集中属性 id 的非 null 枚举。每个枚举元素都属于 String 类。如果属性集的属性数为零，则返回空枚举。

put

Attribute put(String attrID,
              Object val)

向属性集中添加新属性。

参数：: attrID - 要添加的属性的非 null id。如果属性集忽略其属性 id 的字符大小写，则忽略 attrID 的大小写。; val - 要添加的属性的可能为 null 的值。如果为 null，则属性不具有任何值。

返回：

以前在此属性集中的具有 attrID 的 Attribute；如果不存在这种属性，则返回 null。

另请参见：

remove(java.lang.String)

put

Attribute put(Attribute attr)