JavaTM Platform
Standard Ed. 6

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 - valuenull の場合
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 を返します。keynull の場合、またはこの 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 - keynull の場合
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 - keynull の場合
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 - valuenull の場合
ClassCastException - valueCompositeData 型でない場合
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 - keynull の場合
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 - keynull の場合
InvalidKeyException - key がこの TabularData インスタンスの TabularType 定義に適合しない場合

putAll

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

定義:
インタフェース Map<Object,Object> 内の putAll
パラメータ:
t - マップ。 このマップの値が、新しい行として この TabularData インスタンスに追加される。tnull または空文字列の場合、このメソッドは何もせずに 終了する
例外:
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 インスタンスに追加される。 valuesnull または空文字列の場合、 このメソッドは何もせずに終了する
例外:
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 インスタンスに含まれる行のコレクションビューを返します。返される CollectionCollection<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 を返します。

これらの条件が満たされていれば、この 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 インスタンス t1t2 で、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 インスタンスの文字列表現

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。