-
- 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 方法 描述 Object
clone()
创建属性集的副本。Attribute
get(String attrID)
使用属性集中的给定属性id检索属性。NamingEnumeration<? extends Attribute>
getAll()
检索属性集中属性的枚举。NamingEnumeration<String>
getIDs()
检索属性集中属性ID的枚举。boolean
isCaseIgnored()
确定属性集是否在检索或添加属性时忽略属性标识符的情况。Attribute
put(String attrID, Object val)
向属性集添加一个新属性。Attribute
put(Attribute attr)
向属性集添加一个新属性。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()
创建属性集的副本。 新集合包含与原始集合相同的属性:属性本身不被克隆。 副本的更改不会影响原始文件,反之亦然。- 结果
- 此属性集的非空拷贝。
-
-