- すべての実装されたインタフェース:
Serializable
,Cloneable
,Map<Object,
,Object> TabularData
TabularDataSupport
クラスは、TabularData
およびMap
インタフェースを実装する「オープン・データ」クラスで、ハッシュ・マップ・データ構造に基づいて内部的に使用されます。- 導入されたバージョン:
- 1.5
- 関連項目:
-
ネストされたクラスのサマリー
-
コンストラクタのサマリー
コンストラクタ説明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
インスタンスからすべての行を削除します。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
を返します。entrySet()
このTabularDataSupport
インスタンスに含まれる行マッピングのインデックスのコレクション・ビューを返します。boolean
指定されたobjパラメータとこのTabularDataSupport
インスタンスが等しいかどうかを比較します。このメソッドは、単にget((Object[]) key)
をコールします。このTabularData
インスタンスで、索引がkeyのCompositeData
値を返します。keyにマッピングする値がない場合は、null
を返します。このTabularData
インスタンスを記述する「表形式タイプ」を返します。int
hashCode()
このTabularDataSupport
インスタンスのハッシュ・コード値を返します。boolean
isEmpty()
このTabularDataSupport
インスタンスに行が含まれていない場合は、true
を返します。keySet()
このTabularDataSupport
インスタンスの配下のマップに含まれるキーのセット・ビューを返します。これらのキーは、行の指定に使用されます。このメソッドは、単純にput((CompositeData) value)
をコールするため、null
のkeyパラメータは無視されます。void
put
(CompositeData value) valueをこのTabularData
インスタンスに追加します。void
指定されたマップtに含まれるすべての値をこのTabularData
インスタンスに追加します。void
putAll
(CompositeData[] values) valuesのすべての要素をこのTabularData
インスタンスに追加します。このメソッドは、単にremove((Object[]) key)
をコールします。このTabularData
インスタンスから索引がkeyのCompositeData
値を削除し、削除された値を返します。または、索引がkeyの値がない場合はnull
を返します。int
size()
このTabularDataSupport
インスタンス内の行数を返します。toString()
このTabularDataSupport
インスタンスの文字列表現を返します。values()
このTabularDataSupport
インスタンスに格納されている行のコレクション・ビューを返します。インタフェース 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を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
を返します。- 定義:
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
このメソッドは、単に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
このメソッドは、単純に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
このメソッドは、単に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
インスタンスからすべての行を削除します。 -
size
public int size()このTabularDataSupport
インスタンス内の行数を返します。 -
isEmpty
public boolean isEmpty()このTabularDataSupport
インスタンスに行が含まれていない場合は、true
を返します。 -
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>)
オペレーションはサポートされていません。 -
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>)
操作はサポートされていません。 -
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
インスタンスに格納された行マッピングのインデックスが壊れることがあります。 -
clone
public Object clone()このTabularDataSupport
インスタンスのクローンを返します: クローンを取得するには、super.clone()
をコールし、基礎となるマップをクローニングします。 配下のマップのシャロー・クローンのみが作成されます。つまり、不変であるインデックスや行の値のクローニングは行われません。 -
equals
public boolean equals(Object obj) 指定されたobjパラメータとこのTabularDataSupport
インスタンスが等しいかどうかを比較します。次のすべての条件が満たされている場合に限り、
true
を返します。- objがnullでない
- objが
TabularData
インタフェースも実装している - 表型が等しい
- 内容(すべてのCompositeData値)が等しい
equals
メソッドは、TabularData
インタフェースの異なる実装であるobjパラメータに対して適切に機能します。
-
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
インスタンスと等しくなる場合もあります。しかし、計算方法が異なっているため、ハッシュ・コードも異なっている可能性があります。 -
toString
public String toString()このTabularDataSupport
インスタンスの文字列表現を返します。文字列表現は、このクラス(ie
javax.management.openmbean.TabularDataSupport
)の名前、このインスタンスの表形式タイプの文字列表現、およびコンテンツ(ieは、dataMap.
toString()
へのコールによって返されるkey=valueマッピングをリスト)の文字列表現で構成されます。- 定義:
toString
、インタフェースTabularData
- オーバーライド:
toString
、クラスObject
- 戻り値:
- この
TabularDataSupport
インスタンスの文字列表現
-