javax.management.openmbean
類別 CompositeDataSupport

java.lang.Object
  javax.management.openmbean.CompositeDataSupport

所有已實作的介面：

Serializable, CompositeData

public class CompositeDataSupport
extends Object
implements CompositeData, Serializable

CompositeDataSupport 類別是實作 CompositeData 介面的開放資料 類別。

從以下版本開始：

1.5

另請參見：

序列化表格

建構子摘要

CompositeDataSupport(CompositeType compositeType, Map<String,?> items)
使用指定的 compositeType（其項名稱和對應值由 items 映射中的映射關係給出）建構一個 CompositeDataSupport 實例。

CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues)
使用指定的 compositeType（其項值由 itemValues[] 按照與 itemNames[] 中相同的順序指定）建構一個 CompositeDataSupport 實例。

方法摘要

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

從類別 java.lang.Object 繼承的方法

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

建構子詳細資訊

CompositeDataSupport

public CompositeDataSupport(CompositeType compositeType,
                            String[] itemNames,
                            Object[] itemValues)
                     throws OpenDataException

使用指定的 compositeType（其項值由 itemValues[] 按照與 itemNames[] 中相同的順序指定）建構一個 CompositeDataSupport 實例。由於 CompositeType 未對其項指定任何順序，所以使用 itemNames[] 參數指定在 itemValues[] 中給出的值的順序。此 CompositeDataSupport 實例中包含的項內部存儲在 TreeMap 中，並且按它們名稱的升序字典順序進行存儲，以便於對各個項值進行較快速的檢索。

建構子檢查是否滿足下面為每個參數列出的所有約束條件，如果無法滿足，則拋出適當的異常。

參數：

compositeType - 此復合資料 實例的復合型別；不可以為 null。

itemNames - itemNames 必須以任一順序列出在 compositeType 中定義的所有項名稱；使用列出名稱的順序來比對 itemValues[] 中的值；不可以為 null 或空。

itemValues - 按與 itemNames 中它們各自名稱相同的順序列出的項的值；每個項值可以為 null，但是，如果為非 null，則它必須是在 compositeType 中為對應的項定義的開放型別的有效值；大小必須與 itemNames 相同；不可以為 null 或空。

拋出：

IllegalArgumentException - compositeType 為 null，或者 itemNames[] 或 itemValues[] 為 null 或空，或者 itemNames[] 中的元素之一為 null 或空字元串，或者 itemNames[] 和 itemValues[] 的大小不相同。

OpenDataException - itemNames[] 或 itemValues[] 的大小與 compositeType 中定義的項數不同，或者 itemNames[] 中的元素之一不作為在 compositeType 中定義的項名稱存在，或者 itemValues[] 中的元素之一不是 compositeType 中定義的相應項的有效值。

CompositeDataSupport

public CompositeDataSupport(CompositeType compositeType,
                            Map<String,?> items)
                     throws OpenDataException

使用指定的 compositeType（其項名稱和對應值由 items 映射中的映射關係給出）建構一個 CompositeDataSupport 實例。此建構子將鍵轉換為一個字元串陣列，將值轉換為一個物件陣列，並調用 CompositeDataSupport(javax.management.openmbean.CompositeType, java.lang.String[], java.lang.Object[])。

參數：

compositeType - 此復合資料 實例的復合型別；不可以為 null。

items - 所有項名稱到它們的值的映射；items 必須包含 compositeType 中定義的所有項名稱；不可以為 null 或空。

拋出：

IllegalArgumentException - compositeType 為 null，或者 items 為 null 或空，或者 items 中的鍵之一為 null 或空字元串，或者 items 中的值之一為 null。

OpenDataException - items 的大小與 compositeType 中定義的項數不同，或者 items 中的鍵之一不作為 compositeType 中定義的項名稱存在，或者 items 中的值之一不是 compositeType 中定義的相應項的有效值。

ArrayStoreException - items 中的一個或多個鍵不是 java.lang.String 類別。

方法詳細資訊

getCompositeType

public CompositeType getCompositeType()

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

指定者：

介面 CompositeData 中的 getCompositeType

返回：

此 CompositeData 的型別。

get

public Object get(String key)

返回其名稱是 key 的項的值。

指定者：

介面 CompositeData 中的 get

參數：

key - 項的名稱。

返回：

與此鍵關聯的值。

拋出：

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

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

getAll

public Object[] getAll(String[] keys)

返回由 keys 指定其項名稱的值的陣列，順序與 keys 相同。

指定者：

介面 CompositeData 中的 getAll

返回：

與鍵對應的值。

拋出：

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

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

containsKey

public boolean containsKey(String key)

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

指定者：

介面 CompositeData 中的 containsKey

參數：

key - 要測試的鍵。

返回：

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

containsValue

public boolean containsValue(Object value)

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

指定者：

介面 CompositeData 中的 containsValue

參數：

value - 要測試的值。

返回：

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

values

public Collection<?> values()

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

指定者：

介面 CompositeData 中的 values

返回：

值。

equals

public boolean equals(Object obj)

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

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

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

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

指定者：

介面 CompositeData 中的 equals

覆寫：

類別 Object 中的 equals

參數：

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

返回：

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

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

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

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

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

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

指定者：

介面 CompositeData 中的 hashCode

覆寫：

類別 Object 中的 hashCode

返回：

此 CompositeDataSupport 實例的雜湊碼值

另請參見：

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

toString

public String toString()

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

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

指定者：

介面 CompositeData 中的 toString

覆寫：

類別 Object 中的 toString

返回：

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