javax.management.openmbean
クラス TabularDataSupport

java.lang.Object
  javax.management.openmbean.TabularDataSupport

すべての実装されたインタフェース:

Serializable, Cloneable, Map<Object,Object>, TabularData

public class TabularDataSupport
extends Object
implements TabularData, Map<Object,Object>, Cloneable, Serializable

TabularDataSupport クラスは、TabularData インタフェースと Map インタフェースを実装し、内部でハッシュマップデータ構造に基づいている「公開データ」クラスです。

導入されたバージョン:

1.5

関連項目:

直列化された形式

入れ子のクラスの概要

インタフェース java.util.Map から継承された入れ子のクラス/インタフェース

Map.Entry<K,V>

コンストラクタの概要

TabularDataSupport(TabularType tabularType)
公開型が tabularType で、配下の HashMap がデフォルトの初期容量 (101) とデフォルトの負荷係数 (0.75) になっている空の TabularDataSupport インスタンスを作成します。

TabularDataSupport(TabularType tabularType, int initialCapacity, float loadFactor)
公開型が tabularType で、配下の HashMap が指定された初期容量および負荷係数になっている空の TabularDataSupport インスタンスを作成します。

メソッドの概要

Object[]	calculateIndex(CompositeData value) この TabularData インスタンスに、指定された複合データ value パラメータを参照するために使用されるインデックスが追加されている場合、このインデックスを計算します。
void	clear() この TabularDataSupport インスタンスからすべての行を削除します。
Object	clone() この TabularDataSupport インスタンスの複製を返します。
boolean	containsKey(Object key) この TabularData インスタンスに、インデックスが指定された key になっている CompositeData 値 (行) が含まれる場合にかぎり true を返します。
boolean	containsKey(Object[] key) この TabularData インスタンスに、インデックスが指定された key になっている CompositeData 値 (行) が含まれる場合にかぎり true を返します。
boolean	containsValue(CompositeData value) この TabularData インスタンスに、指定された CompositeData 値が含まれる場合にかぎり true を返します。
boolean	containsValue(Object value) この TabularData インスタンスに、指定された値が含まれる場合にかぎり true を返します。
Set<Map.Entry<Object,Object>>	entrySet() この TabularDataSupport インスタンスに含まれる行マッピングのインデックスのコレクションビューを返します。
boolean	equals(Object obj) 指定された obj パラメータとこの TabularDataSupport インスタンスが等しいかどうかを比較します。
Object	get(Object key) このメソッドは単純に get((Object[]) key) を呼び出します。
CompositeData	get(Object[] key) この TabularData インスタンス内に、インデックスが key または null になっている (key に一致する値がない場合) の CompositeData 値を返します。
TabularType	getTabularType() この TabularData インスタンスを記述する「表型」を返します。
int	hashCode() この TabularDataSupport インスタンスのハッシュコード値を返します。
boolean	isEmpty() この TabularDataSupport インスタンスに行が含まれない場合は true を返します。
Set<Object>	keySet() この TabularDataSupport インスタンスの配下のマップに含まれるキーのセットビューを返します。
void	put(CompositeData value) この TabularData インスタンスに value を追加します。
Object	put(Object key, Object value) このメソッドは、単純に put((CompositeData) value) を呼び出します。
void	putAll(CompositeData[] values) values 内のすべての要素をこの TabularData インスタンスに追加します。
void	putAll(Map<?,?> t) 指定されたマップ t 内のすべての値を、この TabularData インスタンスに追加します。
Object	remove(Object key) このメソッドは単純に remove((Object[]) key) を呼び出します。
CompositeData	remove(Object[] key) インデックスがこの TabularData インスタンスの key になっている CompositeData 値を削除し、削除された値を返します。
int	size() この TabularDataSupport インスタンス内の行数を返します。
String	toString() この TabularDataSupport インスタンスの文字列表現を返します。
Collection<Object>	values() この TabularDataSupport インスタンスに含まれる行のコレクションビューを返します。

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

TabularDataSupport

public TabularDataSupport(TabularType tabularType)

公開型が tabularType で、配下の HashMap がデフォルトの初期容量 (101) とデフォルトの負荷係数 (0.75) になっている空の TabularDataSupport インスタンスを作成します。

このコンストラクタは、単純に this(tabularType, 101, 0.75f); を呼び出します。

パラメータ:

tabularType - この TabularData インスタンスを記述する「表型」。 null 以外

例外:

IllegalArgumentException - 表型が null の場合

TabularDataSupport

public TabularDataSupport(TabularType tabularType,
                          int initialCapacity,
                          float loadFactor)

公開型が tabularType で、配下の HashMap が指定された初期容量および負荷係数になっている空の TabularDataSupport インスタンスを作成します。

パラメータ:

tabularType - この TabularData インスタンスを記述する「表型」。 null 以外

initialCapacity - HashMap の初期容量

loadFactor - HashMap の負荷係数

例外:

IllegalArgumentException - 初期容量がゼロより小さい場合、 負荷係数が正ではない場合、 または表型が null の場合

メソッドの詳細

getTabularType

public TabularType getTabularType()

この TabularData インスタンスを記述する「表型」を返します。

定義:

インタフェース TabularData 内の getTabularType

戻り値:

表型

calculateIndex

public Object[] calculateIndex(CompositeData value)

この TabularData インスタンスに、指定された複合データ value パラメータを参照するために使用されるインデックスが追加されている場合、このインデックスを計算します。このメソッドは、指定された value の型の妥当性を検査します。 ただし、計算されたインデックスが、この TabularData インスタンス内の値を参照するためにすでに使用されているかどうかは検査しません。

定義:

インタフェース TabularData 内の calculateIndex

パラメータ:

value - 複合データ値。 この TabularData インスタンス内のこのデータ値のインデックスを計算する。 このインスタンスの行の型と同じ複合型で、 null 以外

戻り値:

指定された value がこの TabularData インスタンス内に持つインデックス

例外:

NullPointerException - value が null の場合

InvalidOpenTypeException - value がこの TabularData インスタンスの行の型定義に 準拠していない場合

containsKey

public boolean containsKey(Object key)

この TabularData インスタンスに、インデックスが指定された key になっている CompositeData 値 (行) が含まれる場合にかぎり true を返します。key を Object インスタンスの 1 次元配列にキャストできない場合、このメソッドは false を返します。 それ以外の場合は、this.containsKey((Object[]) key) の呼び出しの結果を返します。

定義:

インタフェース Map<Object,Object> 内の containsKey

パラメータ:

key - この TabularData 内にあるかどうかテストされるインデックス値

戻り値:

この TabularData が指定されたキーを持つ行の値を示す場合は true

containsKey

public boolean containsKey(Object[] key)

この TabularData インスタンスに、インデックスが指定された key になっている CompositeData 値 (行) が含まれる場合にかぎり true を返します。key が null の場合、またはこの TabularData インスタンスの TabularType 定義に準拠していない場合、このメソッドは false を返します。

定義:

インタフェース TabularData 内の containsKey

パラメータ:

key - この TabularData 内にあるかどうかテストされるインデックス値

戻り値:

この TabularData が指定されたキーを持つ行の値を示す場合は true

containsValue

public boolean containsValue(CompositeData value)

この TabularData インスタンスに、指定された CompositeData 値が含まれる場合にかぎり true を返します。value が null の場合、またはこの TabularData インスタンスの行の型定義に準拠していない場合、このメソッドは false を返します。

定義:

インタフェース TabularData 内の containsValue

パラメータ:

value - この TabularData 内にあるかどうかテストされる行の値

戻り値:

この TabularData インスタンスに指定された行の値が含まれる場合は true

containsValue

public boolean containsValue(Object value)

この TabularData インスタンスに、指定された値が含まれる場合にかぎり true を返します。

定義:

インタフェース Map<Object,Object> 内の containsValue

パラメータ:

value - この TabularData 内にあるかどうかテストされる行の値

戻り値:

この TabularData インスタンスに指定された行の値が含まれる場合は true

get

public Object get(Object key)

このメソッドは単純に get((Object[]) key) を呼び出します。

定義:

インタフェース Map<Object,Object> 内の get

パラメータ:

key - 関連付けられた値が返されるキー

戻り値:

指定されたキーがマップされている値。そのキーのマッピングがこのマップに含まれていない場合は null

例外:

NullPointerException - key が null の場合

ClassCastException - key の型が Object[] でない場合

InvalidKeyException - key がこの TabularData インスタンスの TabularType 定義に適合しない場合

get

public CompositeData get(Object[] key)

この TabularData インスタンス内に、インデックスが key または null になっている (key に一致する値がない場合) の CompositeData 値を返します。

定義:

インタフェース TabularData 内の get

パラメータ:

key - この TabularData インスタンス内に取得する値のインデックス。 この TabularData インスタンスの行の型定義に対して有効 かつ null 以外でなければならない

戻り値:

key に対応する値

例外:

NullPointerException - key が null の場合

InvalidKeyException - key がこの TabularData インスタンスの TabularType 型定義に適合しない場合

put

public Object put(Object key,
                  Object value)

このメソッドは、単純に put((CompositeData) value) を呼び出します。 したがって、key パラメータ (null も可能) は無視します。

定義:

インタフェース Map<Object,Object> 内の put

パラメータ:

key - 無視されるパラメータ

value - 設定する CompositeData

戻り値:

設定される値

例外:

NullPointerException - value が null の場合

ClassCastException - value が CompositeData 型でない場合

InvalidOpenTypeException - value が この TabularData インスタンスの TabularType 定義に適合しない場合

KeyAlreadyExistsException - この TabularData インスタンスの TabularType 定義に準拠するように 計算された value パラメータのキーが、 既存の値とすでに一致している場合

put

public void put(CompositeData value)

インタフェース TabularData の記述:

この TabularData インスタンスに value を追加します。value の複合型は、このインスタンスの行の型 (this.getTabularType().getRowType() によって返される複合型) と同じである必要があります。 また、この TabularData インスタンス内に、追加される value 用に計算されたインデックスを持つ既存の値が存在していてはいけません。value のインデックスは、この TabularData インスタンスの TabularType 定義に従って計算されます (TabularType.getIndexNames() を参照)。

定義:

インタフェース TabularData 内の put

パラメータ:

value - この TabularData インスタンスに新しい行として追加される複合データ値。 このインスタンスの行の型と同じ複合型で、 null 以外でなければならない

remove

public Object remove(Object key)

このメソッドは単純に remove((Object[]) key) を呼び出します。

定義:

インタフェース Map<Object,Object> 内の remove

パラメータ:

key - 削除されるキーを表す Object[]

戻り値:

指定されたキーと関連付けられていた以前の値。キーのマッピングがなかった場合は null。

例外:

NullPointerException - key が null の場合

ClassCastException - key の型が Object[] でない場合

InvalidKeyException - key がこの TabularData インスタンスの TabularType 定義に適合しない場合

remove

public CompositeData remove(Object[] key)

インデックスがこの TabularData インスタンスの key になっている CompositeData 値を削除し、削除された値を返します。インデックスが key の値がない場合は null を返します。

定義:

インタフェース TabularData 内の remove

パラメータ:

key - この TabularData インスタンス内に取得する値のインデックス。 この TabularData インスタンスの行の型定義に対して有効 かつ null 以外でなければならない

戻り値:

指定されたキーと関連付けられていた以前の値。キーのマッピングがなかった場合は null。

例外:

NullPointerException - key が null の場合

InvalidKeyException - key がこの TabularData インスタンスの TabularType 定義に適合しない場合

putAll

public void putAll(Map<?,?> t)

指定されたマップ t 内のすべての値を、この TabularData インスタンスに追加します。このメソッドは、このマップ内の値の集合を CompositeData 値の配列に変換することができれば変換し、putAll(CompositeData[]) メソッドを呼び出します。指定されたマップ t 内で使用されたキーは無視されます。このメソッドを使って、たとえば、同じ行型 (インデックス名は異なっていてもよい) の別の TabularData インスタンスの内容を、このインスタンスに追加することができます。

定義:

インタフェース Map<Object,Object> 内の putAll

パラメータ:

t - マップ。 このマップの値が、新しい行として この TabularData インスタンスに追加される。t が null または空文字列の場合、このメソッドは何もせずに 終了する

例外:

NullPointerException - t 内の値が null の場合

ClassCastException - t 内の値が CompositeData のインスタンスでない場合

InvalidOpenTypeException - t 内の値が この TabularData インスタンスの行の 型定義に適合しない場合

KeyAlreadyExistsException - この TabularData インスタンスの TabularType 定義に準拠するように 計算された t 内の値のインデックスが、 このインスタンス内の既存の値にすでに一致している場合、 または t 内に同じインデックスを 持つ値が 2 つ存在する場合

putAll

public void putAll(CompositeData[] values)

values 内のすべての要素をこの TabularData インスタンスに追加します。values 内に、put で定義された制約を満たさない要素がある場合、または values 内の 2 つの要素で、この TabularData インスタンスの TabularType 定義に準拠するように計算されたインデックスが同じになっている場合、障害を記述する例外がスローされ、values の要素は追加されません。 したがって、この TabularData インスタンスは変更されません。

定義:

インタフェース TabularData 内の putAll

パラメータ:

values - 複合データ値の配列。 この値が、 新しい行としてこの TabularData インスタンスに追加される。 values が null または空文字列の場合、 このメソッドは何もせずに終了する

例外:

NullPointerException - value の要素が null の場合

InvalidOpenTypeException - values の要素が この TabularData インスタンスの行の 型定義 (TabularType 定義) に 準拠していない場合

KeyAlreadyExistsException - この TabularData インスタンスの TabularType 定義に 準拠するように計算された values の要素のインデックスが、 このインスタンス内の既存の値にすでに一致している場合、 または values 内に 同じインデックスを持つ要素が 2 つ存在する場合

clear

public void clear()

この TabularDataSupport インスタンスからすべての行を削除します。

定義:

インタフェース Map<Object,Object> 内の clear

定義:

インタフェース TabularData 内の clear

size

public int size()

この TabularDataSupport インスタンス内の行数を返します。

定義:

インタフェース Map<Object,Object> 内の size

定義:

インタフェース TabularData 内の size

戻り値:

この TabularDataSupport インスタンス内の行数

isEmpty

public boolean isEmpty()

この TabularDataSupport インスタンスに行が含まれない場合は true を返します。

定義:

インタフェース Map<Object,Object> 内の isEmpty

定義:

インタフェース TabularData 内の isEmpty

戻り値:

この TabularDataSupport インスタンスに行が含まれない場合は true

keySet

public Set<Object> keySet()

この TabularDataSupport インスタンスの配下のマップに含まれるキーのセットビューを返します。 これらのキーは、行の指定に使用されます。この Set に含まれる各キーは変更不能な List<?> です。このため、返されるセットビューは Set<List<?>> ですが、互換性を維持する目的で Set<Object> として宣言されます。セットは、この TabularDataSupport インスタンスの配下のマップに連動しており、TabularDataSupport インスタンスの変更はセットに、セットの変更は TabularDataSupport に反映されます。 セットは、要素の削除をサポートします。 要素を削除すると、Iterator.remove(), Set.remove(java.lang.Object)、Set.removeAll(java.util.Collection)、Set.retainAll(java.util.Collection)、および Set.clear() の各オペレーションにより、この TabularDataSupport インスタンスから対応する行が削除されます。Set.add(E) および Set.addAll(java.util.Collection) オペレーションはサポートされていません。

定義:

インタフェース Map<Object,Object> 内の keySet

定義:

インタフェース TabularData 内の keySet

戻り値:

この TabularDataSupport インスタンスの行を指定するために使用されるキーのセットビュー (Set<List<?>>)

values

public Collection<Object> values()

この TabularDataSupport インスタンスに含まれる行のコレクションビューを返します。返される Collection は Collection<CompositeData> ですが、互換性を維持するために Collection<Object> として宣言されます。返されるコレクションを使って、値の繰り返し処理を行うことができます。コレクションは配下のマップに連動しており、TabularDataSupport インスタンスの変更はコレクションに、コレクションの変更は TabularDataSupport に反映されます。 コレクションは、要素の削除をサポートします。 要素を削除すると、Iterator.remove()、Collection.remove(java.lang.Object)、Collection.removeAll(java.util.Collection)、Collection.retainAll(java.util.Collection)、および Collection.clear() の各オペレーションにより、この TabularDataSupport インスタンスから対応する行マッピングのインデックスが削除されます。Collection.add(E) および Collection.addAll(java.util.Collection) オペレーションはサポートされていません。

定義:

インタフェース Map<Object,Object> 内の values

定義:

インタフェース TabularData 内の values

戻り値:

この TabularDataSupport インスタンスに含まれる値の コレクションビュー (Collection<CompositeData>)

entrySet

public Set<Map.Entry<Object,Object>> entrySet()

この TabularDataSupport インスタンスに含まれる行マッピングのインデックスのコレクションビューを返します。返されるコレクションの各要素は Map.Entry<List<?>,CompositeData> ですが、互換性を維持するために Map.Entry<Object,Object> として宣言されます。各マップエントリキーは変更不能な List<?> です。コレクションは、この TabularDataSupport インスタンスの配下のマップに連動しており、TabularDataSupport インスタンスの変更はコレクションに、コレクションの変更は TabularDataSupport に反映されます。コレクションは、要素の削除をサポートします。 要素を削除すると、Iterator.remove()、Collection.remove(java.lang.Object)、Collection.removeAll(java.util.Collection)、Collection.retainAll(java.util.Collection)、および Collection.clear() の各オペレーションにより、対応するマッピングがマップから削除されます。Collection.add(E) および Collection.addAll(java.util.Collection) オペレーションはサポートされていません。

重要:返されるコレクションビュー内の Map.Entry 要素の setValue メソッドは使用しないでください。使用すると、この TabularDataSupport インスタンスに格納された行マッピングのインデックスが壊れることがあります。

定義:

インタフェース Map<Object,Object> 内の entrySet

戻り値:

このマップに含まれるマッピングの コレクションビュー (Set<Map.Entry<List<?>,CompositeData>>)

関連項目:

Map.Entry

clone

public Object clone()

この TabularDataSupport インスタンスの複製を返します。複製は、super.clone() を呼び出し、配下のマップを複製することによって取得されます。配下のマップの浅い複製が作成されます。 つまり、不変であるインデックスや行の値の複製は行われません。

オーバーライド:

クラス Object 内の clone

戻り値:

このインスタンスの複製

関連項目:

Cloneable

equals

public boolean equals(Object obj)

指定された obj パラメータとこの TabularDataSupport インスタンスが等しいかどうかを比較します。

次のすべての条件が満たされている場合にかぎり、true を返します。

• obj が null でない
• obj が TabularData インタフェースを実装している
• 表型が等しい
• 内容 (すべての CompositeData 値) が等しい

これらの条件が満たされていれば、この equals メソッドは、TabularData インタフェースの異なった実装である obj パラメータに対して正常に機能します。

定義:

インタフェース Map<Object,Object> 内の equals

定義:

インタフェース TabularData 内の equals

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - この TabularDataSupport インスタンスと等しいかどうかを比較するオブジェクト

戻り値:

指定されたオブジェクトがこの TabularDataSupport インスタンスと等しい場合は true

関連項目:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

この TabularDataSupport インスタンスのハッシュコード値を返します。

TabularDataSupport インスタンスのハッシュコードは、equals の比較で使用されるすべての情報要素 (「表型」と、すべての CompositeData 値として定義された内容) のハッシュコードの合計です。

これにより、Object.hashCode() メソッドの一般規約によって要求される、任意の 2 つの TabularDataSupport インスタンス t1 と t2 で、t1.equals(t2) であれば t1.hashCode()==t2.hashCode() となることが保証されます。

TabularData インタフェースを実装する別のクラスインスタンスが、equals(java.lang.Object) で定義されているように、この TabularDataSupport インスタンスと等しくなる場合もあります。 しかし、計算方法が異なっているため、ハッシュコードも異なっている可能性があります。

定義:

インタフェース Map<Object,Object> 内の hashCode

定義:

インタフェース TabularData 内の hashCode

オーバーライド:

クラス Object 内の hashCode

戻り値:

この TabularDataSupport インスタンスのハッシュコード値

関連項目:

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

toString

public String toString()

この TabularDataSupport インスタンスの文字列表現を返します。

この文字列表現は、このクラス (javax.management.openmbean.TabularDataSupport) の名前、このインスタンスの表型の文字列表現、および内容 (dataMap.toString() の呼び出しによって返される key=value のマッピングのリスト) の文字列表現で構成されます。

定義:

インタフェース TabularData 内の toString

オーバーライド:

クラス Object 内の toString

戻り値:

この TabularDataSupport インスタンスの文字列表現