JavaTM Platform
Standard Ed. 6

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, Map<String,?> items)
           指定された compositeTypeCompositeDataSupport インスタンスを構築します。
CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues)
           指定された compositeTypeCompositeDataSupport インスタンスを構築します。
 
メソッドの概要
 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 インスタンスに含まれる項目値の変更不能な Collection ビューを返します。
 
クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

CompositeDataSupport

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

指定された compositeTypeCompositeDataSupport インスタンスを構築します。compositeType の項目の値は、itemValues[] によって、itemNames[] と同じ順番で指定されます。CompositeType はその項目の順番を指定しないので、itemValues[] に値を渡す順番の指定には itemNames[] パラメータが使用されます。この 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[] 内のいずれかの要素が compositeType に定義された項目名と一致していない場合、 または itemValues[] 内のいずれかの要素が compositeType に定義されているように対応する項目に対して有効な値でない場合


CompositeDataSupport

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

指定された compositeTypeCompositeDataSupport インスタンスを構築します。compositeType の項目名と対応する値は、マップ 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 または空の文字列のキーが含まれる場合、 または items に null の値が含まれる場合

OpenDataException - items のサイズが compositeType に定義された項目数と異なる場合、 items 内のいずれかのキーが compositeType に定義された項目名と一致していない場合、 または items 内のいずれかの値が compositeType に定義されているように対応する項目に対して有効な値でない場合

ArrayStoreException - items 内の 1 つ以上のキーが java.lang.String クラスでない場合

メソッドの詳細

getCompositeType

public CompositeType getCompositeType()
この「複合データ」インスタンスの「複合型」を返します。

定義:
インタフェース CompositeData 内の getCompositeType
戻り値:
この CompositeData の型

get

public Object get(String key)
key という名前の項目の値を返します。

定義:
インタフェース CompositeData 内の get
パラメータ:
key - 項目の名前
戻り値:
このキーに関連した値
例外:
IllegalArgumentException - key が null または空の String の場合
InvalidKeyException - key が この CompositeData インスタンスの既存の項目名でない場合

getAll

public Object[] getAll(String[] keys)
keys によって、keys と同じ順番で名前を指定された項目の値から成る配列を返します。

定義:
インタフェース CompositeData 内の getAll
パラメータ:
keys - 項目の名前
戻り値:
キーに対応する値
例外:
IllegalArgumentException - keys の要素が null または 空の文字列である場合
InvalidKeyException - keys 内の要素が この CompositeData インスタンスの既存の項目名でない場合

containsKey

public boolean containsKey(String key)
この CompositeData インスタンスに key という名前の項目が含まれる場合に限り、true を返します。key が null または空の String の場合、このメソッドは false を返します。

定義:
インタフェース CompositeData 内の containsKey
パラメータ:
key - 判定されるキー
戻り値:
この CompositeData にキーが含まれる場合は true

containsValue

public boolean containsValue(Object value)
この CompositeData インスタンスに value という値の項目が含まれる場合に限り、true を返します。

定義:
インタフェース CompositeData 内の containsValue
パラメータ:
value - 判定される値
戻り値:
この CompositeData に値が含まれる場合は true

values

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

定義:
インタフェース CompositeData 内の values
戻り値:

equals

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

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

これらの条件が満たされている場合、この equals メソッドは、CompositeData インタフェースの異なった実装である obj パラメータに対して正常に動作します。ただし、java.util.Collection インタフェースの equals メソッドの制約が課されます。

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

hashCode

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

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

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

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

定義:
インタフェース CompositeData 内の hashCode
オーバーライド:
クラス Object 内の hashCode
戻り値:
この CompositeDataSupport インスタンスのハッシュコード値
関連項目:
Object.equals(java.lang.Object), Hashtable

toString

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

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

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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。