- すべての実装されたインタフェース:
Serializable
,CompositeData
CompositeDataSupport
クラスは、CompositeData
インタフェースを実装する公開データ・クラスです。- 導入されたバージョン:
- 1.5
- 関連項目:
-
コンストラクタのサマリー
コンストラクタ説明CompositeDataSupport
(CompositeType compositeType, String[] itemNames, Object[] itemValues) 指定されたcompositeType
でCompositeDataSupport
インスタンスを構築します。その項目の値は、itemValues[]
によって、itemNames[]
と同じ順番で指定されます。CompositeDataSupport
(CompositeType compositeType, Map<String, ?> items) 指定されたcompositeType
でCompositeDataSupport
インスタンスを構築します。compositeTypeの項目名と対応する値は、マップitems
内のマッピングによって指定されます。 -
メソッドのサマリー
修飾子と型メソッド説明boolean
containsKey
(String key) このCompositeData
インスタンスにkey
という名前の項目が含まれる場合に限り、true
を返します。boolean
containsValue
(Object value) このCompositeData
インスタンスにvalue
という値の項目が含まれる場合に限り、true
を返します。boolean
指定されたobjパラメータとこのCompositeDataSupport
インスタンスが等しいかどうかを比較します。key
という名前の項目の値を返します。Object[]
keys
によって、keys
と同じ順番で名前を指定された項目の値から成る配列を返します。この複合データ・インスタンスの複合型を返します。int
hashCode()
このCompositeDataSupport
インスタンスのハッシュ・コード値を返します。toString()
このCompositeDataSupport
インスタンスの文字列表現を返します。Collection<?>
values()
このCompositeData
インスタンスに含まれる項目値の変更不能なCollectionビューを返します。
-
コンストラクタの詳細
-
CompositeDataSupport
public CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues) throws OpenDataException 指定された
compositeType
でCompositeDataSupport
インスタンスを構築します。その項目の値は、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指定された
compositeType
でCompositeDataSupport
インスタンスを構築します。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または空の文字列のキーが含まれる場合。OpenDataException
-items
のサイズがcompositeType
に定義された項目数と異なる場合、items
内のいずれかのキーがcompositeType
に定義された項目名と一致していない場合、またはitems
内のいずれかの値がcompositeType
に定義されている対応する項目に対して有効な値でない場合。ArrayStoreException
-items
内の1つ以上のキーがjava.lang.String
クラスでない場合。
-
-
メソッドの詳細
-
getCompositeType
public CompositeType getCompositeType()この複合データ・インスタンスの複合型を返します。- 定義:
getCompositeType
、インタフェース:CompositeData
- 戻り値:
- このCompositeDataの型。
-
get
key
という名前の項目の値を返します。- 定義:
get
、インタフェース:CompositeData
- パラメータ:
key
- 項目の名前。- 戻り値:
- このキーに関連した値。
- 例外:
IllegalArgumentException
-key
がnullまたは空のStringの場合InvalidKeyException
-key
がこのCompositeData
インスタンスの既存の項目名でない場合
-
getAll
keys
によって、keys
と同じ順番で名前を指定された項目の値から成る配列を返します。- 定義:
getAll
、インタフェース:CompositeData
- パラメータ:
keys
- 項目の名前。- 戻り値:
- キーに対応する値。
- 例外:
IllegalArgumentException
-keys
内の要素がnullまたは空のStringの場合InvalidKeyException
-keys
内の要素がこのCompositeData
インスタンスの既存の項目名でない場合
-
containsKey
public boolean containsKey(String key) このCompositeData
インスタンスにkey
という名前の項目が含まれる場合に限り、true
を返します。key
がnullまたは空のStringの場合、このメソッドは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
インスタンスに含まれる項目値の変更不能なCollectionビューを返します。 返されたコレクションのイテレータは、対応する項目名の値をアルファベットの昇順で返します。- 定義:
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
インスタンスの文字列表現
-