モジュール java.management
パッケージ javax.management.openmbean

インタフェースTabularData

既知のすべての実装クラス:
TabularDataSupport
public interface TabularData
TabularDataインタフェースは、テーブル・データ構造を表現する特定の型の複合公開データ・オブジェクトの動作を指定します。
導入されたバージョン:
1.5

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Object[]
    calculateIndex(CompositeData value)
    このTabularDataインスタンスに、指定された複合データvalueパラメータを参照するために使用されるインデックスが追加されている場合、このインデックスを計算します。
    void
    clear()
    このTabularDataインスタンスからすべてのCompositeData値(行)を削除します。
    boolean
    containsKey(Object[] key)
    このTabularDataインスタンスに、インデックスが指定されたkeyになっているCompositeData値(行)が含まれる場合にかぎりtrueを返します。
    boolean
    containsValue(CompositeData value)
    このTabularDataインスタンスに、指定されたCompositeData値が含まれる場合にかぎりtrueを返します。
    boolean
    equals(Object obj)
    指定されたobjパラメータとこのTabularDataインスタンスが等しいかどうかを比較します。
    CompositeData
    get(Object[] key)
    このTabularDataインスタンス内で、keyをインデックスに持つCompositeData値(keyに値がマッピングされていない場合はnull)を返します。
    TabularType
    getTabularType()
    このTabularDataインスタンスを記述する表型を返します。
    int
    hashCode()
    このTabularDataインスタンスのハッシュ・コード値を返します。
    boolean
    isEmpty()
    このTabularDataインスタンスに含まれるCompositeData値の数(行数)がゼロの場合、trueを返します。
    Set<?>
    keySet()
    このTabularDataインスタンスに含まれるCompositeData値(行)のキー(インデックス値)のセット・ビューを返します。
    void
    put(CompositeData value)
    このTabularDataインスタンスにvalueを追加します。
    void
    putAll(CompositeData[] values)
    values内のすべての要素をこのTabularDataインスタンスに追加します。
    CompositeData
    remove(Object[] key)
    keyをインデックスに持つCompositeData値をこのTabularDataインスタンスから削除し、その削除した値を返します。keyをインデックスに持つ値が存在しない場合はnullを返します。
    int
    size()
    このTabularDataインスタンスに含まれるCompositeData値の数(行数)を返します。
    String
    toString()
    このTabularDataインスタンスの文字列表現を返します。
    Collection<?>
    values()
    このTabularDataインスタンスに含まれるCompositeData値(行)のコレクション・ビューを返します。

  • メソッドの詳細

    • getTabularType

      TabularType getTabularType()
      このTabularDataインスタンスを記述する表型を返します。
      戻り値:
      表型。

    • calculateIndex

      Object[] calculateIndex(CompositeData value)
      このTabularDataインスタンスに、指定された複合データvalueパラメータを参照するために使用されるインデックスが追加されている場合、このインデックスを計算します。 このメソッドは、指定されたvalueの型の妥当性を検査します。ただし、計算されたインデックスが、このTabularDataインスタンス内の値を参照するためにすでに使用されているかどうかは検査しません。
      パラメータ:
      value - 複合データ値。このTabularDataインスタンス内のこのデータ値のインデックスを計算する。このインスタンスの行の型と同じ複合型で、null以外。
      戻り値:
      指定されたvalueがこのTabularDataインスタンス内に持つインデックス。
      例外:
      NullPointerException - valueがnullの場合
      InvalidOpenTypeException - valueがこのTabularDataインスタンスの行の型定義に準拠していない場合。

    • size

      int size()
      このTabularDataインスタンスに含まれるCompositeData値の数(行数)を返します。
      戻り値:
      含まれる値の数。

    • isEmpty

      boolean isEmpty()
      このTabularDataインスタンスに含まれるCompositeData値の数(行数)がゼロの場合、trueを返します。
      戻り値:
      このTabularDataが空の場合はtrue。

    • containsKey

      boolean containsKey(Object[] key)
      このTabularDataインスタンスに、インデックスが指定されたkeyになっているCompositeData値(行)が含まれる場合にかぎりtrueを返します。 keyがnullの場合、またはこのTabularDataインスタンスのTabularType定義に準拠していない場合、このメソッドはfalseを返します。
      パラメータ:
      key - このTabularData内にあるかどうかテストされるインデックス値。
      戻り値:
      このTabularDataが指定されたキーを持つ行の値を示す場合はtrue。

    • containsValue

      boolean containsValue(CompositeData value)
      このTabularDataインスタンスに、指定されたCompositeData値が含まれる場合にかぎりtrueを返します。 valueがnullの場合、またはこのTabularDataインスタンスの行の型定義に準拠していない場合、このメソッドはfalseを返します。
      パラメータ:
      value - このTabularData内にあるかどうかテストされる行の値。
      戻り値:
      このTabularDataインスタンスに指定された行の値が含まれる場合はtrue。

    • get

      CompositeData get(Object[] key)
      このTabularDataインスタンス内で、keyをインデックスに持つCompositeData値(keyに値がマッピングされていない場合はnull)を返します。
      パラメータ:
      key - 返される行のキー。
      戻り値:
      keyに対応する値。
      例外:
      NullPointerException - keyがnullの場合
      InvalidKeyException - keyがこのTabularDataインスタンスのTabularType定義に適合しない場合

    • put

      void put(CompositeData value)
      このTabularDataインスタンスにvalueを追加します。 valueの複合型は、このインスタンスの行の型(this.getTabularType().getRowType()によって返される複合型)と同じである必要があります。また、このTabularDataインスタンス内に、追加されるvalue用に計算されたものと同じインデックスを持つ既存の値が存在していてはいけません。 valueのインデックスは、このTabularDataインスタンスのTabularType定義に従って計算されます(TabularType.getIndexNames()を参照)。
      パラメータ:
      value - このTabularDataインスタンスに新しい行として追加される複合データ値。このインスタンスの行の型と同じ複合型で、null以外でなければならない。
      例外:
      NullPointerException - valueがnullの場合
      InvalidOpenTypeException - valueがこのTabularDataインスタンスの行の型定義に準拠していない場合。
      KeyAlreadyExistsException - このTabularDataインスタンスのTabularType定義に準拠するように計算されたvalueのインデックスが、配下のHashMap内の既存の値とすでに一致している場合。

    • remove

      CompositeData remove(Object[] key)
      keyをインデックスに持つCompositeData値をこのTabularDataインスタンスから削除し、その削除した値を返します。keyをインデックスに持つ値が存在しない場合はnullを返します。
      パラメータ:
      key - このTabularDataインスタンス内に取得する値のインデックス。このTabularDataインスタンスの行の型定義に対して有効かつnull以外でなければならない。
      戻り値:
      指定されたキーと関連付けられていた以前の値。キーのマッピングがなかった場合はnull。
      例外:
      NullPointerException - keyがnullの場合
      InvalidKeyException - keyがこのTabularDataインスタンスのTabularType定義に適合しない場合

    • putAll

      void putAll(CompositeData[] values)
      values内のすべての要素をこのTabularDataインスタンスに追加します。 valuesの要素がputで定義された制約を満たさない場合、またはvaluesの2つの要素がこのTabularDataインスタンスTabularTypeの定義に従って計算された同じインデックスを持つ場合は、その障害を記述する例外がスローされ、valuesの要素が追加されず、このTabularDataインスタンスは変更されません。
      パラメータ:
      values - 複合データ値の配列。この値が、新しい行としてこのTabularDataインスタンスに追加される。valuesがnullまたは空文字列の場合、このメソッドは何もせずに終了する。
      例外:
      NullPointerException - valueの要素がnullの場合
      InvalidOpenTypeException - valueの要素がこのTabularDataインスタンスの行の型定義に準拠していない場合。
      KeyAlreadyExistsException - このTabularDataインスタンスのTabularType定義に準拠するように計算されたvaluesの要素のインデックスが、このインスタンス内の既存の値にすでに一致している場合、またはvalues内に同じインデックスを持つ要素が2つ存在する場合

    • clear

      void clear()
      このTabularDataインスタンスからすべてのCompositeData値(行)を削除します。

    • keySet

      Set<?> keySet()
      このTabularDataインスタンスに含まれるCompositeData値(行)のキー(インデックス値)のセット・ビューを返します。 返されるSetはSet<List<?>>ですが、互換性を維持するためにSet<?>として宣言されます。 返されるセットを使って、キーの繰返し処理を行うことができます。
      戻り値:
      このTabularDataインスタンスで使用されるインデックス値のセット・ビュー(Set<List<?>>)。

    • values

      Collection<?> values()
      このTabularDataインスタンスに含まれるCompositeData値(行)のコレクション・ビューを返します。 返されるCollectionはCollection<CompositeData>ですが、互換性を維持するためにCollection<?>として宣言されます。 返されるコレクションを使って、値の繰返し処理を行うことができます。
      戻り値:
      このTabularDataインスタンスに格納されている行のコレクション・ビュー(Collection<CompositeData>)。

    • equals

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

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

      • objがnullでない
      • objがTabularDataインタフェースも実装している
      • 行型が等しい
      • 内容(インデックスと値のマッピング)が等しい
      これらの条件が満たされていれば、このequalsメソッドは、TabularDataインタフェースの異なった実装であるobjパラメータに対して正常に機能します。
       

      オーバーライド:
      equals 、クラス:  Object
      パラメータ:
      obj - このTabularDataインスタンスと等しいかどうかを比較するオブジェクト。
      戻り値:
      指定されたオブジェクトがこのTabularDataインスタンスと等しい場合はtrue。
      関連項目:

    • hashCode

      int hashCode()
      このTabularDataインスタンスのハッシュ・コード値を返します。

      TabularDataインスタンスのハッシュ・コードは、equalsの比較で使用されるすべての情報要素(表型と、すべての値マッピングのインデックスとして定義された内容)のハッシュ・コードの合計です。

      これにより、Object.hashCode()メソッドの一般規約によって要求される、任意の2つのTabularDataSupportインスタンスt1とt2で、t1.equals(t2)であればt1.hashCode()==t2.hashCode()となることが保証されます。

      オーバーライド:
      hashCode 、クラス:  Object
      戻り値:
      このTabularDataSupportインスタンスのハッシュ・コード値
      関連項目:

    • toString

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

      文字列表現は、実装クラス名と、このインスタンスの表型で構成されます。

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