javax.management.openmbean
介面 CompositeData

所有已知實作類別：

CompositeDataSupport

public interface CompositeData

CompositeData 介面指定表示復合資料 結構的複雜開放資料 物件的特定型別的行為。

從以下版本開始：

1.5

方法摘要

boolean	containsKey(String key) 當且僅當此 CompositeData 實例包含名稱為 key 的項時，返回 true。
boolean	containsValue(Object value) 當且僅當此 CompositeData 實例包含值為 value 的項時，返回 true。
boolean	equals(Object obj) 比較指定 obj 參數與此 CompositeData 實例的相等性。
Object	get(String key) 返回名稱為 key 的項的值。
Object[]	getAll(String[] keys) 返回通過 keys 指定其項名稱的值組成的陣列，值排列的順序與 keys 相同。
CompositeType	getCompositeType() 返回此復合資料 實例的復合型別。
int	hashCode() 返回此 CompositeData 實例的雜湊碼值。
String	toString() 返回此 CompositeData 實例的字元串表示形式。
Collection<?>	values() 返回此 CompositeData 實例中所包含項值的不可修改的 Collection 視圖。

方法詳細資訊

getCompositeType

CompositeType getCompositeType()

返回此復合資料 實例的復合型別。

返回：

此 CompositeData 的型別。

get

Object get(String key)

返回名稱為 key 的項的值。

參數：

key - 項的名稱。

返回：

與此鍵關聯的值。

拋出：

IllegalArgumentException - 如果 key 為 null 或空字元串。

InvalidKeyException - 如果 key 不是此 CompositeData 實例的現有項的名稱。

getAll

Object[] getAll(String[] keys)

返回通過 keys 指定其項名稱的值組成的陣列，值排列的順序與 keys 相同。

參數：

key - 項的名稱。

返回：

與鍵對應的值。

拋出：

IllegalArgumentException - 如果 keys 中的元素為 null 或空字元串。

InvalidKeyException - 如果 keys 中的元素不是此 CompositeData 實例的現有項的名稱。

containsKey

boolean containsKey(String key)

當且僅當此 CompositeData 實例包含名稱為 key 的項時，返回 true。如果 key 為 null 或空字元串，則此方法只返回 false。

參數：

key - 要測試的鍵。

返回：

如果此 CompositeData 套件含該鍵，則返回 true。

containsValue

boolean containsValue(Object value)

當且僅當此 CompositeData 實例包含值為 value 的項時，返回 true。

參數：

value - 要測試的值。

返回：

如果此 CompositeData 套件含該值，則返回 true。

values

Collection<?> values()

返回此 CompositeData 實例中所包含項值的不可修改的 Collection 視圖。返回集合的迭代器將按相應項名稱的升序字典順序返回值。

返回：

值。

equals

boolean equals(Object obj)

比較指定 obj 參數與此 CompositeData 實例的相等性。

當且僅當下面的所有語句均為 true 時，才返回 true：

• obj 為非 null，
• obj 還實作 CompositeData 介面
• 它們的復合型別相等
• 它們的內容（即（名稱，值）對）相等。如果內容中包含的值是一個陣列，則對於物件參考型別陣列，值比較操作的執行方式類似於調用 deepEquals 方法；對於基本型別陣列，則類似於調用恰當的 Arrays.equals(e1,e2) 重載形式。

這確保了此 equals 方法對 obj 參數正常工作，該參數是 CompositeData 介面的不同實作，具有 java.util.Collection 介面的 equals 方法中提到的約束限制。

覆寫：

類別 Object 中的 equals

參數：

obj - 與此 CompositeData 實例進行相等性比較的物件。

返回：

如果指定的物件等於此 CompositeData 實例，則返回 true。

另請參見：

Object.hashCode(), Hashtable

hashCode

int hashCode()

返回此 CompositeData 實例的雜湊碼值。

CompositeData 實例的雜湊碼是在 equals 比較中使用的所有資訊元素的雜湊碼的總和（即其復合型別 和所有項值）。

這確保了 t1.equals(t2) 意味著對於任何兩個 CompositeData 實例 t1 和 t2 而言，都存在 t1.hashCode()==t2.hashCode()，這是方法 Object.hashCode() 的通用協定所要求的。

每項值的雜湊碼將被添加到返回的雜湊碼中。如果項值是一個陣列，則對於物件參考型別陣列，其雜湊碼的獲取方式類似於調用 deepHashCode 方法；對於基本型別陣列，則類似於調用恰當的 Arrays.hashCode(e) 重載形式。

覆寫：

類別 Object 中的 hashCode

返回：

此 CompositeData 實例的雜湊碼值

另請參見：

Object.equals(java.lang.Object), Hashtable

toString

String toString()

返回此 CompositeData 實例的字元串表示形式。

字元串表示形式由實作類別的名稱、此實例的復合型別的字元串表示形式以及內容的字元串表示形式組成，即列出 itemName=itemValue 映射關係。

覆寫：

類別 Object 中的 toString

返回：

此 CompositeData 實例的字元串表示形式