compact3

javax.naming.directory

Interface Attributes

All Superinterfaces:

Cloneable ， Serializable

所有已知实现类：

BasicAttributes

public interface Attributes
extends Cloneable, Serializable

此接口表示属性的集合。

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

实现Attributes接口的对象中的属性是无序的。 该对象可以具有零个或多个属性。 属性区分大小写或不区分大小写（case-ignore）。 此属性在创建Attributes对象时确定。 （例如，参见BasicAttributes构造函数）。 在不区分大小写的属性中，在搜索属性或添加属性时忽略其属性标识符的情况。 在区分大小写属性中，情况很重要。

请注意，属性的更新（例如添加或删除属性）不会影响目录中的对应表示。 只能使用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

方法摘要

Modifier and Type	Method and Description
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; 否则为假。

size

int size()

检索属性集中的属性数。

结果

此属性集中的非负数属性集。

get

Attribute get(String attrID)

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

参数

attrID - 要检索的属性的非空ID。 如果此属性集忽略其属性ID的字符大小写，则忽略attrID的情况。

结果

由attrID标识的属性; 如果找不到null。

另请参见：

put(java.lang.String, java.lang.Object) ， remove(java.lang.String)

getAll

NamingEnumeration<? extends Attribute> getAll()

检索属性集中属性的枚举。 在此枚举上设置的此属性的更新效果未定义。

结果

此属性集中属性的非空枚举。 枚举的每个元素都是类别Attribute 。 如果属性集具有零属性，则返回一个空的枚举。

getIDs

NamingEnumeration<String> getIDs()

检索属性集中属性ID的枚举。 在此枚举上设置的此属性的更新效果未定义。

结果

属性集中的属性ID的非空枚举。 枚举的每个元素都是String类。 如果属性集具有零属性，则返回一个空的枚举。

put

Attribute put(String attrID,
              Object val)

向属性集添加一个新属性。

参数

attrID - non-null要添加的属性的id。 如果属性集忽略其属性id的字符大小写，则忽略attrID的情况。

val - 要添加的属性的可能的空值。 如果为null，则该属性不具有任何值。

结果

此属性集中以前的attrID属性; 如果不存在这样的属性，则为null。

另请参见：

remove(java.lang.String)

put

Attribute put(Attribute attr)

向属性集添加一个新属性。

参数

attr - 要添加的非空属性。 如果属性集忽略其属性ID的字符大小写，则忽略attr标识符的情况。

结果

与该属性集中以前的attr具有相同ID的属性; 如果不存在这样的属性，则为null。

另请参见：

remove(java.lang.String)

remove

Attribute remove(String attrID)

从属性集中删除属性id“attrID”的属性。 如果属性不存在，请忽略。

参数

attrID - 要删除的属性的非空ID。 如果属性集忽略其属性id的字符大小写，则忽略attrID的情况。

结果

与属性集中以前的attrID具有相同ID的属性; 如果不存在这样的属性，则为null。

clone

Object clone()

创建属性集的副本。 新集合包含与原始集合相同的属性：属性本身不被克隆。 副本的更改不会影响原始文件，反之亦然。

结果

此属性集的非空拷贝。