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

クラスCompositeDataSupport

java.lang.Object
javax.management.openmbean.CompositeDataSupport
すべての実装されたインタフェース:
Serializable, CompositeData
public class CompositeDataSupport extends Object implements CompositeData, Serializable
CompositeDataSupportクラスは、CompositeDataインタフェースを実装する「オープン・データ」クラスです。
導入されたバージョン:
1.5
関連項目:

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

    コンストラクタ
    コンストラクタ
    説明
    CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues)
    指定されたcompositeTypeでCompositeDataSupportインスタンスを作成します。このcompositeTypeのアイテム値は、itemNames[]と同じ順序でitemValues[]で指定されます。
    CompositeDataSupport(CompositeType compositeType, Map<String,?> items)
    指定されたcompositeTypeでCompositeDataSupportインスタンスを構築します。このインスタンスでは、マップitemsのマッピングによってアイテム名と対応する値が指定されます。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    containsKey(String key)
    このCompositeDataインスタンスにkeyという名前のアイテムが含まれている場合にのみ、trueを返します。
    boolean
    containsValue(Object value)
    このCompositeDataインスタンスに、値がvalueのアイテムが含まれている場合のみ、trueを返します。
    boolean
    equals(Object obj)
    指定されたobjパラメータとこのCompositeDataSupportインスタンスが等しいかどうかを比較します。
    Object
    get(String key)
    名前がkeyのアイテムの値を返します。
    Object[]
    getAll(String[] keys)
    keysで指定された名前を持つアイテムの値の配列を、keysと同じ順序で返します。
    CompositeType
    getCompositeType()
    この複合データ・インスタンスの複合型を返します。
    int
    hashCode()
    このCompositeDataSupportインスタンスのハッシュ・コード値を返します。
    String
    toString()
    このCompositeDataSupportインスタンスの文字列表現を返します。
    Collection<?>
    values()
    このCompositeDataインスタンスに含まれるアイテム値の変更不可能なコレクション・ビューを返します。

    クラス java.lang.Objectで宣言されたメソッド

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • コンストラクタの詳細

    • CompositeDataSupport

      public CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues) throws OpenDataException

      指定されたcompositeTypeでCompositeDataSupportインスタンスを作成します。このcompositeTypeのアイテム値は、itemNames[]と同じ順序でitemValues[]で指定されます。 CompositeTypeではアイテムに順序が指定されていないため、itemNames[]パラメータを使用して、itemValues[]で値が指定される順序を指定します。 このCompositeDataSupportインスタンスに含まれるアイテムは、内部的にTreeMapに格納されるため、個々のアイテム値の取得を高速化するために、名前の辞書順で昇順にソートされます。

      コンストラクタは、各パラメータが以下のすべての制約を満たしていることを確認し、満たされていない制約がある場合は適切な例外をスローします。

      パラメータ:
      compositeType - この複合データ・インスタンスの複合型。null以外。
      itemNames - itemNamesは、compositeTypeで定義されているすべてのアイテム名を任意の順序でリストする必要があります。名前がリストされる順序は、itemValues[]の値に一致するために使用されます。nullまたは空にできません。
      itemValues - アイテムの値は、itemNamesのそれぞれの名前と同じ順序でリストされます。各アイテム値はnullにできますが、null以外の場合は、対応するアイテムのcompositeTypeで定義されたオープン・タイプに有効な値である必要があります。itemNamesと同じサイズである必要があります。nullまたは空にしないでください。
      例外:
      IllegalArgumentException - compositeTypeがnullであるか、itemNames[]またはitemValues[]がnullまたは空であるか、itemNames[]の要素のいずれかがnullまたは空の文字列であるか、itemNames[]およびitemValues[]が同じサイズではありません。
      OpenDataException - itemNames[]またはitemValues[]のサイズがcompositeTypeで定義されているアイテムの数と異なるか、itemNames[]の要素の1つがcompositeTypeで定義されているアイテム名として存在しないか、itemValues[]の要素の1つが、compositeTypeで定義されている対応するアイテムの有効な値ではありません。

    • CompositeDataSupport

      public CompositeDataSupport(CompositeType compositeType, Map<String,?> items) throws OpenDataException

      指定されたcompositeTypeでCompositeDataSupportインスタンスを構築します。このインスタンスでは、マップitemsのマッピングによってアイテム名と対応する値が指定されます。 このコンストラクタは、キーを文字列配列に変換し、値をオブジェクト配列に変換してCompositeDataSupport(javax.management.openmbean.CompositeType, java.lang.String[], java.lang.Object[])をコールします。

      パラメータ:
      compositeType - この複合データ・インスタンスの複合型。null以外。
      items - すべてのアイテム名の値へのマッピング。itemsには、compositeTypeで定義されているすべてのアイテム名が含まれている必要があります。nullまたは空にできません。
      例外:
      IllegalArgumentException - compositeTypeがnullであるか、itemsがnullまたは空であるか、items内のキーのいずれかがnullまたは空の文字列です。
      OpenDataException - items 'サイズがcompositeTypeに定義されているアイテムの数と異なるか、items内のキーの1つがcompositeTypeに定義されているアイテム名として存在しないか、items内の値の1つが、compositeTypeに定義されている対応するアイテムの有効な値ではありません。
      ArrayStoreException - itemsの1つ以上のキーがクラスjava.lang.Stringではありません。

  • メソッドの詳細

    • getCompositeType

      public CompositeType getCompositeType()
      この複合データ・インスタンスの複合型を返します。
      定義:
      getCompositeType、インタフェースCompositeData
      戻り値:
      このCompositeDataの型。

    • get

      public Object get(String key)
      名前がkeyのアイテムの値を返します。
      定義:
      get、インタフェースCompositeData
      パラメータ:
      key - 項目の名前。
      戻り値:
      このキーに関連した値。
      例外:
      IllegalArgumentException - keyがnullまたは空の文字列の場合。
      InvalidKeyException - keyがこのCompositeDataインスタンスの既存のアイテム名でない場合。

    • getAll

      public Object[] getAll(String[] keys)
      keysで指定された名前を持つアイテムの値の配列を、keysと同じ順序で返します。
      定義:
      getAll、インタフェースCompositeData
      パラメータ:
      keys - 項目の名前。
      戻り値:
      キーに対応する値。
      例外:
      IllegalArgumentException - keysの要素がnullまたは空の文字列である場合。
      InvalidKeyException - keysの要素がこのCompositeDataインスタンスの既存のアイテム名でない場合。

    • containsKey

      public boolean containsKey(String key)
      このCompositeDataインスタンスにkeyという名前のアイテムが含まれている場合にのみ、trueを返します。 keyがnullまたは空の文字列の場合、このメソッドは単にfalseを返します。
      定義:
      containsKey、インタフェースCompositeData
      パラメータ:
      key - 判定されるキー。
      戻り値:
      このCompositeDataにキーが含まれている場合はtrue。

    • containsValue

      public boolean containsValue(Object value)
      このCompositeDataインスタンスに、値がvalueのアイテムが含まれている場合のみ、trueを返します。
      定義:
      containsValue、インタフェースCompositeData
      パラメータ:
      value - 判定される値。
      戻り値:
      このCompositeDataに値が含まれている場合はtrue。

    • values

      public Collection<?> values()
      このCompositeDataインスタンスに含まれるアイテム値の変更不可能なコレクション・ビューを返します。 返されたコレクションのイテレータは、対応する項目名の値をアルファベットの昇順で返します。
      定義:
      values、インタフェースCompositeData
      戻り値:
      値

    • equals

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

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

      • objがnullでない
      • objがCompositeDataインタフェースも実装している
      • 複合型が等しい
      • 内容、すなわち名前と値のペアが等しい。 内容に含まれる値が配列である場合、オブジェクト参照型の配列に対してdeepEqualsメソッドを呼び出すか、またはプリミティブ型の配列に対してArrays.equals(e1,e2)の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます

      これにより、このequalsメソッドは、CompositeDataインタフェースの異なる実装であるobjパラメータに対して正しく機能し、java.util.Collectionインタフェースのequalsメソッドに示されている制限があります。

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

    • hashCode

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

      CompositeDataSupportインスタンスのハッシュ・コードは、equalsの比較で使用されるすべての情報要素(複合型およびすべての項目値)のハッシュ・コードの合計です。

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

      各項目値のハッシュ・コードは、返されたハッシュ・コードに追加されます。 項目値が配列である場合、オブジェクト参照型の配列に対してdeepHashCodeメソッドを呼び出すか、またはプリミティブ型の配列に対してArrays.hashCode(e)の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます。

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

    • toString

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

      この文字列表現は、このクラス(javax.management.openmbean.CompositeDataSupport)の名前、このインタフェースの複合型の文字列表現、および内容(itemName=itemValueのマッピングのリスト)の文字列表現で構成されます。

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