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)

向屬性集中添加新屬性。

參數：

attr - 要添加的非 null 屬性。如果屬性集忽略其屬性 id 的字元大小寫，則忽略 attr 標識符的大小寫。

返回：

以前在此屬性集中的與 attr 具有相同 ID 的 Attribute；如果不存在這種屬性，則返回 null。

另請參見：

remove(java.lang.String)

remove

Attribute remove(String attrID)

從屬性集中移除屬性 id 為 'attrID' 的屬性。如果該屬性不存在，則忽略。

參數：

attrID - 要移除的屬性的非 null id。如果屬性集忽略其屬性 id 的字元大小寫，則忽略 attrID 的大小寫。

返回：

以前在屬性集中的與 attrID 具有相同 ID 的 Attribute；如果不存在這種屬性，則返回 null。

clone

Object clone()

對屬性集進行複製。新集合包含與初始集合相同的屬性：這些屬性不是其本身的副本。對副本的更改不會影響原件，反之亦然。

返回：

此屬性集的非 null 副本。