クラス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>>)。
      関連項目:

    • clone

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

    • 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。
      関連項目:

    • 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インスタンスのハッシュ・コード値
      関連項目:

    • toString

      public String toString()
      このTabularDataSupportインスタンスの文字列表現を返します。

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

      定義:
      toString、インタフェースTabularData
      オーバーライド:
      toString、クラスObject
      戻り値:
      このTabularDataSupportインスタンスの文字列表現