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) 指定された compositeType で CompositeDataSupport インスタンスを構築します。compositeType の項目名と対応する値は、マップ items 内のマッピングによって指定されます。
CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues) 指定された compositeType で CompositeDataSupport インスタンスを構築します。その項目の値は、itemValues[] によって、itemNames[] と同じ順番で指定されます。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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

指定された 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

public Object get(String key)

key という名前の項目の値を返します。

定義:

get、インタフェース: CompositeData

パラメータ:

key - 項目の名前

戻り値:

このキーに関連した値

例外:

IllegalArgumentException - key が null または空の String の場合

InvalidKeyException - key がこの CompositeData インスタンスの既存の項目名でない場合

getAll

public Object[] getAll(String[] keys)

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

関連項目:

Object.hashCode()、HashMap

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 インスタンスのハッシュコード値

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

この CompositeDataSupport インスタンスの文字列表現を返します。

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

定義:

toString、インタフェース: CompositeData

オーバーライド:

toString、クラス: Object

戻り値:

この CompositeDataSupport インスタンスの文字列表現