TabularDataSupport (Java Platform SE 7)

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` インスタンスの複製を返します。複製は、`super.clone()` を呼び出し、配下のマップを複製することによって取得されます。
`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` をインデックスに持つ `CompositeData` 値 (`key` に値がマッピングされていない場合は `null`) を返します。
`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)` を呼び出します。したがって、`key` パラメータ (`null` も可能) は無視します。
`void`	`putAll(CompositeData[] values)` `values` 内のすべての要素をこの `TabularData` インスタンスに追加します。
`void`	`putAll(Map<?,?> t)` 指定されたマップ `t` 内のすべての値を、この `TabularData` インスタンスに追加します。
`Object`	`remove(Object key)` このメソッドは単純に `remove((Object[]) key)` を呼び出します。
`CompositeData`	`remove(Object[] key)` `key` をインデックスに持つ `CompositeData` 値をこの `TabularData` インスタンスから削除し、その削除した値を返します。`key` をインデックスに持つ値が存在しない場合は `null` を返します。
`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 インスタンスを記述する表型を返します。
    
    定義:
    
    getTabularType、インタフェース: TabularData
    
    戻り値:
    表型。
  - calculateIndex
```
public Object[] calculateIndex(CompositeData value)
```
    この TabularData インスタンスに、指定された複合データ value パラメータを参照するために使用されるインデックスが追加されている場合、このインデックスを計算します。このメソッドは、指定された 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) の呼び出しの結果を返します。
    
    定義:
    
    containsKey、インタフェース: Map<Object,Object>
    
    パラメータ:
    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 を返します。
    
    定義:
    
    containsValue、インタフェース: Map<Object,Object>
    
    パラメータ:
    value - この TabularData 内にあるかどうかテストされる行の値。
    
    戻り値:
    この TabularData インスタンスに指定された行の値が含まれる場合は true。
  - get
```
public Object get(Object key)
```
    このメソッドは単純に get((Object[]) key) を呼び出します。
    
    定義:
    
    get、インタフェース: Map<Object,Object>
    
    パラメータ:
    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) を呼び出します。したがって、key パラメータ (null も可能) は無視します。
    
    定義:
    
    put、インタフェース: Map<Object,Object>
    
    パラメータ:
    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() を参照)。
    
    定義:
    
    put、インタフェース: TabularData
    
    パラメータ:
    value - この TabularData インスタンスに新しい行として追加される複合データ値。このインスタンスの行の型と同じ複合型で、null 以外でなければならない。
  - remove
```
public Object remove(Object key)
```
    このメソッドは単純に remove((Object[]) key) を呼び出します。
    
    定義:
    
    remove、インタフェース: Map<Object,Object>
    
    パラメータ:
    key - 削除されるキーを表す Object[]。
    
    戻り値:
    指定されたキーと関連付けられていた以前の値。キーのマッピングがなかった場合は null。
    
    例外:
    
    NullPointerException - key が null の場合
    
    ClassCastException - key の型が Object[] でない場合
    
    InvalidKeyException - key がこの TabularData インスタンスの TabularType 定義に適合しない場合
  - remove
```
public CompositeData remove(Object[] key)
```
    key をインデックスに持つ CompositeData 値をこの TabularData インスタンスから削除し、その削除した値を返します。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 インスタンスの内容を、このインスタンスに追加することができます。
    
    定義:
    
    putAll、インタフェース: Map<Object,Object>
    
    パラメータ:
    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 - value の要素が null の場合
    
    InvalidOpenTypeException - values の要素がこの TabularData インスタンスの行の型定義 (TabularType 定義) に準拠していない場合
    
    KeyAlreadyExistsException - この TabularData インスタンスの TabularType 定義に準拠するように計算された values の要素のインデックスが、このインスタンス内の既存の値にすでに一致している場合、または values 内に同じインデックスを持つ要素が 2 つ存在する場合
  - clear
```
public void clear()
```
    この TabularDataSupport インスタンスからすべての行を削除します。
    
    定義:
    
    clear、インタフェース: Map<Object,Object>
    
    定義:
    
    clear、インタフェース: TabularData
  - size
```
public int size()
```
    この TabularDataSupport インスタンス内の行数を返します。
    
    定義:
    
    size、インタフェース: Map<Object,Object>
    
    定義:
    
    size、インタフェース: TabularData
    
    戻り値:
    この TabularDataSupport インスタンス内の行数。
  - isEmpty
```
public boolean isEmpty()
```
    この TabularDataSupport インスタンスに行が含まれない場合は true を返します。
    
    定義:
    
    isEmpty、インタフェース: Map<Object,Object>
    
    定義:
    
    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>) 操作はサポートされていません。
    
    定義:
    
    keySet、インタフェース: Map<Object,Object>
    
    定義:
    
    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>) 操作はサポートされていません。
    
    定義:
    
    values、インタフェース: Map<Object,Object>
    
    定義:
    
    values、インタフェース: TabularData
    
    戻り値:
    この TabularDataSupport インスタンスに格納されている値のコレクションビュー (Collection<CompositeData>)。
  - entrySet
```
public Set<Map.Entry<Object,Object>> entrySet()
```
    この TabularDataSupport インスタンスに含まれる行マッピングのインデックスのコレクションビューを返します。返されるコレクションの各要素は Map.Entry<Object,Object> ですが、互換性を維持するために Map.Entry<List<?>,CompositeData> として宣言されます。各マップエントリキーは変更不能な 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 インスタンスに格納された行マッピングのインデックスが壊れることがあります。
    
    定義:
    
    entrySet、インタフェース: Map<Object,Object>
    
    戻り値:
    マップ内に保持されているマッピングのコレクションビュー (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 パラメータに対して正常に機能します。
    定義:
    
    equals、インタフェース: Map<Object,Object>
    
    定義:
    
    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 インスタンスと等しくなる場合もあります。しかし、計算方法が異なっているため、ハッシュコードも異なっている可能性があります。
    
    定義:
    
    hashCode、インタフェース: Map<Object,Object>
    
    定義:
    
    hashCode、インタフェース: TabularData
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    この TabularDataSupport インスタンスのハッシュコード値
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    この TabularDataSupport インスタンスの文字列表現を返します。
    この文字列表現は、このクラス (javax.management.openmbean.TabularDataSupport) の名前、このインスタンスの表型の文字列表現、および内容 (dataMap.toString() の呼び出しによって返される key=value のマッピングのリスト) の文字列表現で構成されます。
    
    定義:
    
    toString、インタフェース: TabularData
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    この TabularDataSupport インスタンスの文字列表現

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス TabularDataSupport

ネストされたクラスのサマリー

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

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

TabularDataSupport

TabularDataSupport

メソッドの詳細

getTabularType

calculateIndex

containsKey

containsKey

containsValue

containsValue

get

get

put

put

remove

remove

putAll

putAll

clear

size

isEmpty

keySet

values

entrySet

clone

equals

hashCode

toString