javax.management.openmbean
介面 TabularData

所有已知實作類別：

TabularDataSupport

public interface TabularData

TabularData 介面指定特定型別的複雜開放資料 物件的行為，該物件表示了表格資料 結構。

從以下版本開始：

1.5

方法摘要

Object[]	calculateIndex(CompositeData value) 計算將在此 TabularData 實例中使用的索引，以便在指定的復合資料 value 參數添加到此實例中後參考該參數。
void	clear() 從此 TabularData 實例中移除所有 CompositeData 值（即各行）。
boolean	containsKey(Object[] key) 當且僅當此 TabularData 實例包含其索引為指定 key 的 CompositeData 值（即行）時，才返回 true。
boolean	containsValue(CompositeData value) 當且僅當此 TabularData 實例包含指定的 CompositeData 值時才返回 true。
boolean	equals(Object obj) 比較指定的 obj 參數與此 TabularData 實例的相等性。
CompositeData	get(Object[] key) 返回此 TabularData 實例中其索引為 key 的 CompositeData 值，如果沒有映射到 key 的值，則返回 null。
TabularType	getTabularType() 返回描述此 TabularData 實例的表格型別。
int	hashCode() 返回此 TabularData 實例的雜湊碼值。
boolean	isEmpty() 如果此 TabularData 實例中包含的 CompositeData 值的數目（即行數）為零，則返回 true。
Set<?>	keySet() 返回此 TabularData 實例中包含的 CompositeData 值（即各行）的鍵（即索引值）的 set 視圖。
void	put(CompositeData value) 將 value 添加到此 TabularData 實例。
void	putAll(CompositeData[] values) 將 values 中的所有元素添加到此 TabularData 實例。
CompositeData	remove(Object[] key) 從此 TabularData 實例中移除其索引為 key 的 CompositeData 值，並返回被移除的值，如果不存在索引為 key 的值，則返回 null。
int	size() 返回此 TabularData 實例中包含的 CompositeData 值的數目（即行數）。
String	toString() 返回此 TabularData 實例的字元串表示形式。
Collection<?>	values() 返回此 TabularData 實例中包含的 CompositeData 值（即各行）的 collection 視圖。

方法詳細資訊

getTabularType

TabularType getTabularType()

返回描述此 TabularData 實例的表格型別。

返回：

表格型別。

calculateIndex

Object[] calculateIndex(CompositeData value)

計算將在此 TabularData 實例中使用的索引，以便在指定的復合資料 value 參數添加到此實例中後參考該參數。此方法檢查指定 value 的型別有效性，但不檢查計算的索引是否已用於參考此 TabularData 實例中的值。

參數：

value - 要計算其在此 TabularData 實例中索引的復合資料值；必須是與此實例的行型別相同的復合型別；而且不可以為 null。

返回：

此 TabularData 實例中指定的 value 將具有的索引。

拋出：

NullPointerException - 如果 value 為 null

InvalidOpenTypeException - 如果 value 不符合此 TabularData 實例的行型別定義。

size

int size()

返回此 TabularData 實例中包含的 CompositeData 值的數目（即行數）。

返回：

包含的值的數目。

isEmpty

boolean isEmpty()

如果此 TabularData 實例中包含的 CompositeData 值的數目（即行數）為零，則返回 true。

返回：

如果此 TabularData 為空，則返回 true。

containsKey

boolean containsKey(Object[] key)

當且僅當此 TabularData 實例包含其索引為指定 key 的 CompositeData 值（即行）時，才返回 true。如果 key 為 null 或者不符合此 TabularData 實例的 TabularType 定義，則此方法僅返回 false。

參數：

key - 將測試其是否存在於此 TabularData 實例中的索引值。

返回：

如果此 TabularData 使用指定的鍵來索引一個行值，則返回 true。

containsValue

boolean containsValue(CompositeData value)

當且僅當此 TabularData 實例包含指定的 CompositeData 值時才返回 true。如果 value 為 null 或者不符合此 TabularData 實例的行型別定義，則此方法僅返回 false。

參數：

value - 將測試其在此 TabularData 實例中的存在性的行值。

返回：

如果此 TabularData 實例包含指定的行值，則返回 true。

get

CompositeData get(Object[] key)

返回此 TabularData 實例中其索引為 key 的 CompositeData 值，如果沒有映射到 key 的值，則返回 null。

參數：

key - 要返回的行的鍵。

返回：

與 key 對應的值。

拋出：

NullPointerException - 如果 key 為 null

InvalidKeyException - 如果 key 不符合此 TabularData 實例的 * TabularType 定義

put

void put(CompositeData value)

將 value 添加到此 TabularData 實例。value 的復合型別必須與此實例的行型別（即 this.getTabularType().getRowType() 返回的復合型別）相同，並且此 TabularData 實例中現有值的索引不能與要添加的 value 計算的索引相同。value 的索引是根據此 TabularData 實例的 TabularType 定義計算的（請參見 TabularType.getIndexNames()）。

參數：

value - 要作為新行添加到此 TabularData 實例中的復合資料值；必須是與此實例的行型別相同的復合型別；並且不可以為 null。

拋出：

NullPointerException - 如果 value 為 null

InvalidOpenTypeException - 如果 value 不符合此 TabularData 實例的行型別定義。

KeyAlreadyExistsException - 如果根據此 TabularData 實例的 TabularType 定義計算的 value 的索引已經映射到基礎 HashMap 中現有的值。

remove

CompositeData remove(Object[] key)

從此 TabularData 實例中移除其索引為 key 的 CompositeData 值，並返回被移除的值，如果不存在索引為 key 的值，則返回 null。

參數：

key - 要獲取的此 TabularData 實例中值的索引；必須對此 TabularData 實例的行型別定義有效；並且不可以為 null。

返回：

以前與指定鍵相關聯的值，如果沒有該鍵的映射關係，則返回 null。

拋出：

NullPointerException - 如果 key 為 null

InvalidKeyException - 如果 key 不符合此 TabularData 實例的 TabularType 定義

putAll

void putAll(CompositeData[] values)

將 values 中的所有元素添加到此 TabularData 實例。如果根據此 TabularData 實例的 TabularType 定義計算的 values 中的任何元素都不滿足 put 中定義的約束，或者 values 中的任何兩個元素具有相同的索引，則拋出一個描述失敗的異常，並且不添加 values 的任何元素，因此，此 TabularData 實例保持不變。

參數：

values - 作為新行添加到此 TabularData 實例的復合資料值的陣列；如果 values 為 null 或者為空，則此方法直接返回且不執行任何操作。

拋出：

NullPointerException - 如果 values 的一個元素為 null

InvalidOpenTypeException - 如果 values 的某個元素不符合此 TabularData 實例的行型別定義

KeyAlreadyExistsException - 如果根據此 TabularData 實例的 TabularType 定義計算的 values 的某個元素的索引已經映射到此實例中現有的值，或者 values 的兩個元素具有相同的索引。

clear

void clear()

從此 TabularData 實例中移除所有 CompositeData 值（即各行）。

keySet

Set<?> keySet()

返回此 TabularData 實例中包含的 CompositeData 值（即各行）的鍵（即索引值）的 set 視圖。返回的 Set 是一個 Set<List<?>>，但出於相容性原因被宣告為 Set<?>。然後可以使用返回的 Set 對鍵進行迭代。

返回：

此 TabularData 實例中使用的索引值的 set 視圖 (Set<List<?>>)。

values

Collection<?> values()

返回此 TabularData 實例中包含的 CompositeData 值（即各行）的 collection 視圖。返回的 Collection 是一個 Collection<CompositeData><?>>，但出於相容性原因被宣告為 Collection<?>。然後可以使用返回的 collection 對值進行迭代。

返回：

此 TabularData 實例中包含的行的 collection 視圖 (Collection<CompositeData>)。

equals

boolean equals(Object obj)

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

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

• obj 為非 null
• obj 還實作 TabularData 介面
• 它們的行型別相同
• 它們的內容（即值映射的索引）相等

這確保了此 equals 方法對作為 TabularData 介面的不同實作的 obj 參數正常工作。

覆寫：

類別 Object 中的 equals

參數：

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

返回：

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

另請參見：

Object.hashCode(), Hashtable

hashCode

int hashCode()

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

TabularData 實例的雜湊碼是在 equals 比較中使用的資訊的所有元素的雜湊碼總和（即其表格型別 及其內容，其中內容被定義為值映射的所有索引）。

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

覆寫：

類別 Object 中的 hashCode

返回：

此 TabularDataSupport 實例的雜湊碼值

另請參見：

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

toString

String toString()

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

該字元串表示形式由實作類別的名稱和此實例的表格型別組成。

覆寫：

類別 Object 中的 toString

返回：

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