- すべての実装されたインタフェース:
Serializable,CompositeData
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のマッピングによってアイテム名と対応する値が指定されます。 -
メソッドのサマリー
修飾子と型メソッド説明booleancontainsKey(String key) このCompositeDataインスタンスにkeyという名前のアイテムが含まれている場合にのみ、trueを返します。booleancontainsValue(Object value) このCompositeDataインスタンスに、値がvalueのアイテムが含まれている場合のみ、trueを返します。boolean指定されたobjパラメータとこのCompositeDataSupportインスタンスが等しいかどうかを比較します。名前がkeyのアイテムの値を返します。Object[]keysで指定された名前を持つアイテムの値の配列を、keysと同じ順序で返します。この複合データ・インスタンスの複合型を返します。inthashCode()このCompositeDataSupportインスタンスのハッシュ・コード値を返します。toString()このCompositeDataSupportインスタンスの文字列表現を返します。Collection<?> values()このCompositeDataインスタンスに含まれるアイテム値の変更不可能なコレクション・ビューを返します。
-
コンストラクタの詳細
-
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
名前がkeyのアイテムの値を返します。- 定義:
get、インタフェースCompositeData- パラメータ:
key- 項目の名前。- 戻り値:
- このキーに関連した値。
- 例外:
IllegalArgumentException-keyがnullまたは空の文字列の場合。InvalidKeyException-keyがこのCompositeDataインスタンスの既存のアイテム名でない場合。
-
getAll
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インスタンスの文字列表現
-