パッケージ javax.management.openmbean

公開データ型と Open MBean 記述子クラスを提供します。

参照先:
説明

インタフェースの概要

CompositeData	CompositeData インタフェースは、「複合データ」構造を表現する特定の型の複合「公開データ」オブジェクトの動作を指定します。
CompositeDataView	Java クラスは、このインタフェースを実装することにより、MXBean フレームワークを使って CompositeData に変換する方法を示すことができます。
OpenMBeanAttributeInfo	公開 MBean の属性を記述します。
OpenMBeanConstructorInfo	Open MBean のコンストラクタを記述します。
OpenMBeanInfo	Open MBean を記述します。
OpenMBeanOperationInfo	Open MBean のオペレーションを記述します。
OpenMBeanParameterInfo	公開 MBean の 1 つ以上のオペレーションまたはコンストラクタで使用されるパラメータを記述します。
TabularData	TabularData インタフェースは、「テーブルデータ」構造を表現する特定の型の複合「公開データ」オブジェクトの動作を指定します。

クラスの概要

ArrayType<T>	ArrayType クラスは、「公開データ」値の n 次元配列であるすべての「公開データ」値を記述するインスタンスを持つ「公開型」クラスです。
CompositeDataInvocationHandler	public interface NamedNumber { public int getNumber(); public String getName(); } また、CompositeData は次のように構築されます。
CompositeDataSupport	CompositeDataSupport クラスは、CompositeData インタフェースを実装する「公開データ」クラスです。
CompositeType	CompositeType クラスは、CompositeData 値の型を記述するインスタンスを持つ「公開型」クラスです。
OpenMBeanAttributeInfoSupport	公開 MBean の属性を記述します。
OpenMBeanConstructorInfoSupport	Open MBean のコンストラクタを記述します。
OpenMBeanInfoSupport	OpenMBeanInfoSupport クラスは、「公開 MBean」の管理情報を記述します。
OpenMBeanOperationInfoSupport	Open MBean のオペレーションを記述します。
OpenMBeanParameterInfoSupport	公開 MBean の 1 つ以上のオペレーションまたはコンストラクタで使用されるパラメータを記述します。
OpenType<T>	OpenType クラスは、実際の公開データ値の「公開型」を記述するすべてのクラスの親 abstract クラスです。
SimpleType<T>	SimpleType クラスは、配列でも CompositeData 値でも TabularData 値でもないすべての「公開データ」値を記述するインスタンスを持つ、「公開型」クラスです。
TabularDataSupport	TabularDataSupport クラスは、TabularData インタフェースと Map インタフェースを実装し、内部でハッシュマップデータ構造に基づいている「公開データ」クラスです。
TabularType	TabularType クラスは、TabularData 値の型を記述するインスタンスを持つ「公開型」クラスです。

例外の概要

InvalidKeyException	この実行時例外は、「複合データ」の項目名または「表データ」の行インデックスになる予定だったメソッドパラメータが無効な場合にスローされます。
InvalidOpenTypeException	この実行時例外は、「公開データ」値の「公開型」が予想していた値と異なる場合にスローされます。
KeyAlreadyExistsException	この実行時例外は、「表データ」インスタンスに追加される行のインデックスが、この「表データ」インスタンス内の別の行を参照するためにすでに使用されている場合にスローされます。
OpenDataException	この確認済み例外は、妥当性の制約の一部が満たされていないため、「公開型」、「公開データ」、または「公開 MBean メタデータ情報」インスタンスを構築できなかった場合にスローされます。

パッケージ javax.management.openmbean の説明

公開データ型と Open MBean 記述子クラスを提供します。Open MBean は MBean の一種であり、その属性およびオペレーションパラメータの型と戻り値は、いくつかの事前定義済みの Java クラスを使って構築されます。Open MBean は、アプリケーション固有の型 (非 Java プログラムを含む) に必ずしもアクセスできるとはかぎらないリモート管理プログラムを使って、オペレーションを簡便化します。

すべての MBean は、MBean 自体の情報とその属性、オペレーション、コンストラクタ、および通知を備えた MBeanInfo を持ちます。Open MBean では、この MBeanInfo は、通常 OpenMBeanInfoSupport のインスタンスになることにより、OpenMBeanInfo インタフェースを実装します。

Open MBean の MBeanInfo.getAttributes によって返される属性情報は、 OpenMBeanAttributeInfo を実装するオブジェクト (通常 OpenMBeanAttributeInfoSupport のインスタンス) の配列になります。OpenMBeanAttributeInfo は、属性に関する一般情報に加えて、属性の OpenType を指定します。可能な OpenType 値は事前に定義されているため、リモートマネージャーはこれらを認識します。

オペレーションおよびコンストラクタのパラメータ型、さらにはオペレーションの戻り型についても、同じことが言えます。

getType() によって返される属性の Java 言語型と、getOpenType() によって返されるその OpenType には違いがあります。たとえば、Java 言語型が java.lang.String の場合、OpenType は SimpleType.String になります。Java 言語型が CompositeData の場合、OpenType は属性の CompositeData インスタンス内の項目を記述する CompositeType になります。

デフォルト値と制約

Open MBean では、属性およびパラメータは、関連付けられたデフォルト値や制約を OpenMBeanAttributeInfo または OpenMBeanParameterInfo 内に保持できます。これらの制約を指定するには、2 つの方法があります。OpenMBeanAttributeInfoSupport または OpenMBeanParameterInfoSupport のいずれかのコンストラクタへのパラメータとして値を直接指定する方法 (例、OpenMBeanParameterInfoSupport.OpenMBeanParameterInfoSupport( String, String, OpenType, Object, Object[])) と、いずれかのコンストラクタへのパラメータとして指定された Descriptor 内に値を指定する方法です。

Descriptor を使用する場合、次のフィールドが関連します。

• defaultValue は、getDefaultValue() により返される値を定義します。
• minValue は、getMinValue() により返される値を定義します。
• maxValue は、getMaxValue() により返される値を定義します。
• legalValues は、getLegalValues() により返される値を定義します。

defaultValue、minValue、および maxValue の場合、関連する値は openType に対応する Java 型、またはその型に変換可能な文字列でなければなりません。static メソッド valueOf(String) が検出される場合には、このメソッドが変換に使用されます。このメソッドが検出されない場合、単一の String パラメータを持つコンストラクタが検出される場合にはそのコンストラクタが使用され、そうでない場合には変換が失敗します。

legalValues では、関連する値は配列または Set でなければなりません。また、配列またはセットの要素は、defaultValue などに対して記述された方法で変換可能でなければなりません。

これらのフィールドでは、次の条件を満たす必要があります。

• 値は、すでに説明したように、適切な型の値か、適切な型に変換可能な文字列でなければなりません。
• legalValues が存在する場合は、minValue も maxValue も存在してはいけません。
• defaultValue が存在する場合、legalValues、minValue、maxValue のいずれかが存在するなら、そこで定義された制約を満たしている必要があります。
• minValue と maxValue の両方が存在する場合、minValue が maxValue より大きくてはいけません。

導入されたバージョン:

1.5

関連項目:

Java SE 6 プラットフォームの JMX テクノロジに関するマニュアル、 特に 『JMX 仕様、バージョン 1.4』(pdf)