モジュール java.management

パッケージ 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)	指定したコンポジット・データvalueパラメータ(このインスタンスに追加された場合)を参照するためにこのTabularDataインスタンスで使用される索引を計算します。
void	clear()	このTabularDataSupportインスタンスからすべての行を削除します。
Object	clone()	このTabularDataSupportインスタンスのクローンを返します: クローンを取得するには、super.clone()をコールし、基礎となるマップをクローニングします。
boolean	containsKey(Object key)	このTabularDataインスタンスに、指定されたkeyの索引を持つCompositeData値(つまり、行)が含まれている場合のみ、trueを返します。
boolean	containsKey(Object[] key)	このTabularDataインスタンスに、指定されたkeyの索引を持つCompositeData値(つまり、行)が含まれている場合のみ、trueを返します。
boolean	containsValue(Object value)	このTabularDataインスタンスに指定した値が含まれている場合にのみ、trueを返します。
boolean	containsValue(CompositeData value)	このTabularDataインスタンスに指定したCompositeData値が含まれている場合のみ、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のCompositeData値を返します。keyにマッピングする値がない場合は、nullを返します。
TabularType	getTabularType()	このTabularDataインスタンスを記述する「表形式タイプ」を返します。
int	hashCode()	このTabularDataSupportインスタンスのハッシュ・コード値を返します。
boolean	isEmpty()	このTabularDataSupportインスタンスに行が含まれていない場合は、trueを返します。
Set<Object>	keySet()	このTabularDataSupportインスタンスの配下のマップに含まれるキーのセット・ビューを返します。これらのキーは、行の指定に使用されます。
Object	put(Object key, Object value)	このメソッドは、単純にput((CompositeData) value)をコールするため、nullのkeyパラメータは無視されます。
void	put(CompositeData value)	valueをこのTabularDataインスタンスに追加します。
void	putAll(Map<?,?> t)	指定されたマップtに含まれるすべての値をこのTabularDataインスタンスに追加します。
void	putAll(CompositeData[] values)	valuesのすべての要素をこのTabularDataインスタンスに追加します。
Object	remove(Object key)	このメソッドは、単にremove((Object[]) key)をコールします。
CompositeData	remove(Object[] key)	このTabularDataインスタンスから索引がkeyのCompositeData値を削除し、削除された値を返します。または、索引がkeyの値がない場合はnullを返します。
int	size()	このTabularDataSupportインスタンス内の行数を返します。
String	toString()	このTabularDataSupportインスタンスの文字列表現を返します。
Collection<Object>	values()	このTabularDataSupportインスタンスに格納されている行のコレクション・ビューを返します。

クラスjava.lang.Objectで宣言されたメソッド

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

インタフェースjava.util.Mapで宣言されたメソッド

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

コンストラクタの詳細

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インスタンスを記述する「表形式タイプ」を返します。

定義:

getTabularType、インタフェースTabularData

戻り値:

表型。

calculateIndex

public Object[] calculateIndex(CompositeData value)

指定したコンポジット・データvalueパラメータ(このインスタンスに追加された場合)を参照するためにこのTabularDataインスタンスで使用される索引を計算します。 このメソッドは、指定されたvalueのタイプの有効性をチェックしますが、計算された索引がこのTabularDataインスタンスの値を参照するためにすでに使用されているかどうかはチェックしません。

定義:

calculateIndex、インタフェースTabularData

パラメータ:

value - このTabularDataインスタンスの索引を計算するコンポジット・データ値。このインスタンスの行タイプと同じコンポジット・タイプである必要があります。nullにできません。

戻り値:

指定したvalueがこのTabularDataインスタンスにある索引。

例外:

NullPointerException - valueがnullの場合。

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

containsKey

public boolean containsKey(Object key)

このTabularDataインスタンスに、指定されたkeyの索引を持つCompositeData値(つまり、行)が含まれている場合のみ、trueを返します。 keyをオブジェクト・インスタンスの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を返します。

定義:

containsKey、インタフェースTabularData

パラメータ:

key - このTabularDataインスタンスに存在する索引値をテストします。

戻り値:

このTabularDataが、指定されたキーを持つ行値に索引付けする場合、true。

containsValue

public boolean containsValue(CompositeData value)

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

定義:

containsValue、インタフェースTabularData

パラメータ:

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のCompositeData値を返します。keyにマッピングする値がない場合は、nullを返します。

定義:

get、インタフェースTabularData

パラメータ:

key - このTabularDataインスタンスで取得する値の索引。このTabularDataインスタンスの行タイプ定義で有効である必要があります。nullにできません。

戻り値:

keyに対応する値。

例外:

NullPointerException - keyがnullの場合

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

put

public Object put(Object key, Object value)

このメソッドは、単純にput((CompositeData) value)をコールするため、nullのkeyパラメータは無視されます。

定義:

インタフェース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

valueをこのTabularDataインスタンスに追加します。 valueのコンポジット・タイプは、このインスタンスの行タイプ(this.getTabularType().getRowType() によって返されるコンポジット・タイプ)と同じである必要があり、このTabularDataインスタンスには、索引が追加されるvalueに対して計算されたものと同じである既存の値が存在していない必要があります。 valueの索引は、このTabularDataインスタンスのTabularType定義(TabularType.getIndexNames() を参照してください)に従って計算されます。

定義:

put、インタフェースTabularData

パラメータ:

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を返します。

定義:

remove、インタフェースTabularData

パラメータ:

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インスタンスは変更されません。

定義:

putAll、インタフェースTabularData

パラメータ:

values - このTabularDataインスタンスに新規行として追加されるコンポジット・データ値の配列。valuesがnullまたは空の場合、このメソッドは何もせずに返します。

例外:

NullPointerException - valuesの要素がnullの場合

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

KeyAlreadyExistsException - このTabularDataインスタンスのTabularType定義に従って計算されたvaluesの要素の索引がこのインスタンスの既存の値にすでにマップされている場合、またはvaluesの2つの要素が同じ索引を持つ場合

clear

public void clear()

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

定義:

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

定義:

clear、インタフェースTabularData

size

public int size()

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

定義:

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

定義:

size、インタフェースTabularData

戻り値:

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

isEmpty

public boolean isEmpty()

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

定義:

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

定義:

isEmpty、インタフェースTabularData

戻り値:

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

keySet

public Set<Object> keySet()

このTabularDataSupportインスタンスの配下のマップに含まれるキーのセット・ビューを返します。これらのキーは、行の指定に使用されます。 このSetに含まれる各キーは変更不能なList<?>です。このため、返されるセット・ビューはSet<List<?>>ですが、互換性を維持するためにSet<Object>として宣言されます。 セットは、この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<? extends E>)オペレーションはサポートされていません。

定義:

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

定義:

keySet、インタフェースTabularData

戻り値:

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

values

public Collection<Object> values()

このTabularDataSupportインスタンスに格納されている行のコレクション・ビューを返します。 返されるCollectionはCollection<CompositeData>ですが、互換性を維持するためにCollection<Object>として宣言されます。 返されるコレクションを使って、値の繰返し処理を行うことができます。 コレクションは配下のマップに連動しており、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<? extends E>)操作はサポートされていません。

定義:

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

定義:

values、インタフェースTabularData

戻り値:

このTabularDataSupportインスタンスに格納されている値のコレクション・ビュー(Collection<CompositeData>)。

entrySet

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

このTabularDataSupportインスタンスに含まれる行マッピングのインデックスのコレクション・ビューを返します。 返されるコレクションの各要素はMap.Entry<List<?>,CompositeData>ですが、互換性を維持するためにMap.Entry<Object,Object>として宣言されます。 各マップ・エントリ・キーは変更不能なList<?>です。 コレクションは、この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<? extends E>)操作はサポートされていません。

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

定義:

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

戻り値:

マップ内に保持されているマッピングのコレクション・ビュー(Set<Map.Entry<List<?>,CompositeData>>)。

関連項目:

• Map.Entry

clone

public Object clone()

このTabularDataSupportインスタンスのクローンを返します: クローンを取得するには、super.clone()をコールし、基礎となるマップをクローニングします。 配下のマップのシャロー・クローンのみが作成されます。つまり、不変であるインデックスや行の値のクローニングは行われません。

オーバーライド:

clone、クラスObject

戻り値:

このインスタンスの複製。

関連項目:

• Cloneable

equals

public boolean equals(Object obj)

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

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

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

これにより、このequalsメソッドは、TabularDataインタフェースの異なる実装であるobjパラメータに対して適切に機能します。

定義:

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

定義:

equals、インタフェースTabularData

オーバーライド:

equals、クラスObject

パラメータ:

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

戻り値:

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

関連項目:

• Object.hashCode()
• HashMap

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

定義:

hashCode、インタフェースTabularData

オーバーライド:

hashCode、クラスObject

戻り値:

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

関連項目:

• Map.Entry.hashCode()
• Object.equals(Object)
• Map.equals(Object)

toString

public String toString()

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

文字列表現は、このクラス(ie javax.management.openmbean.TabularDataSupport)の名前、このインスタンスの表形式タイプの文字列表現、およびコンテンツ(ieは、dataMap. toString()へのコールによって返されるkey=valueマッピングをリスト)の文字列表現で構成されます。

定義:

toString、インタフェースTabularData

オーバーライド:

toString、クラスObject

戻り値:

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