ナビゲーション・リンクをスキップ
Java(tm) Platform
Standard Edition 8
compact3

パッケージ javax.management.openmbean

公開データ型とOpen 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の場合、OpenTypeSimpleType.Stringになります。Java言語型がCompositeDataの場合、OpenTypeは属性のCompositeDataインスタンス内の項目を記述するCompositeTypeになります。

デフォルト値と制約

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

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

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

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

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

導入されたバージョン:
1.5
関連項目:
JavaプラットフォームのJMXテクノロジに関するドキュメント、特に『JMX仕様、バージョン1.4
ナビゲーション・リンクをスキップ
Java(tm) Platform
Standard Edition 8

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.