モジュール java.management

パッケージ javax.management

インタフェースDynamicMBean

既知のすべてのサブインタフェース:

DiagnosticCommandMBean, ModelMBean

既知のすべての実装クラス:

RequiredModelMBean, StandardEmitterMBean, StandardMBean

public interface DynamicMBean

Dynamic MBean (動的管理インタフェースを公開するMBean)に実装するメソッドを定義します。

導入されたバージョン:

1.5

メソッドのサマリー

修飾子と型	メソッド	説明
Object	getAttribute(String attribute)	Dynamic MBeanの特定の属性の値を取得します。
AttributeList	getAttributes(String[] attributes)	Dynamic MBeanの複数の属性の値を取得します。
MBeanInfo	getMBeanInfo()	MBeanInfoオブジェクトを使って、Dynamic MBeanの公開属性およびアクションを提供します。
Object	invoke(String actionName, Object[] params, String[] signature)	Dynamic MBean上でのアクションの呼出しを許可します。
void	setAttribute(Attribute attribute)	Dynamic MBeanの特定の属性の値を設定します。
AttributeList	setAttributes(AttributeList attributes)	Dynamic MBeanの複数の属性の値を設定します。

メソッドの詳細

getAttribute

Object getAttribute(String attribute)
             throws AttributeNotFoundException,
                    MBeanException,
                    ReflectionException

Dynamic MBeanの特定の属性の値を取得します。

パラメータ:

attribute - 取得される属性の名前

戻り値:

取得される属性の値。

例外:

AttributeNotFoundException - 指定された属性が存在しないか、または検索できない場合

MBeanException - MBeanのgetterによってスローされるjava.lang.Exceptionをラップする場合

ReflectionException - getterの呼出し時にスローされるjava.lang.Exceptionをラップする場合

関連項目:

setAttribute(javax.management.Attribute)

setAttribute

void setAttribute(Attribute attribute)
           throws AttributeNotFoundException,
                  InvalidAttributeValueException,
                  MBeanException,
                  ReflectionException

Dynamic MBeanの特定の属性の値を設定します。

パラメータ:

attribute - 設定される属性のIDと設定される値。

例外:

AttributeNotFoundException - 指定された属性が存在しないか、または検索できない場合

InvalidAttributeValueException - 指定された値が属性に対して有効でない場合

MBeanException - MBeanのsetterによってスローされるjava.lang.Exceptionをラップする場合。

ReflectionException - MBeanのsetterの呼出し時にスローされるjava.lang.Exceptionをラップする場合

関連項目:

getAttribute(java.lang.String)

getAttributes

AttributeList getAttributes(String[] attributes)

Dynamic MBeanの複数の属性の値を取得します。

パラメータ:

attributes - 取得される属性のリスト。

戻り値:

取得される属性のリスト。

関連項目:

setAttributes(javax.management.AttributeList)

setAttributes

AttributeList setAttributes(AttributeList attributes)

Dynamic MBeanの複数の属性の値を設定します。

パラメータ:

attributes - 属性のリスト。属性のリスト(設定される属性のIDと設定される値)。

戻り値:

設定された属性と新しい値のリスト。

関連項目:

getAttributes(java.lang.String[])

invoke

Object invoke(String actionName,
              Object[] params,
              String[] signature)
       throws MBeanException,
              ReflectionException

Dynamic MBean上でのアクションの呼出しを許可します。

パラメータ:

actionName - 呼び出されるアクションの名前。

params - アクションの呼出し時に設定されるパラメータを含む配列。

signature - アクションのシグニチャを含む配列。 クラス・オブジェクトのロードには、アクションを呼び出すMBeanをロードするときと同じクラス・ローダーが使用される。

戻り値:

アクションによって返されるオブジェクト。指定されたMBean上でのアクションの呼出しの結果を表す。

例外:

MBeanException - MBeanの呼出しメソッドによってスローされるjava.lang.Exceptionをラップする場合。

ReflectionException - メソッドの呼出し時にスローされるjava.lang.Exceptionをラップする場合。

getMBeanInfo

MBeanInfo getMBeanInfo()

MBeanInfoオブジェクトを使って、Dynamic MBeanの公開属性およびアクションを提供します。

戻り値:

MBeanInfoのインスタンス。このDynamic MBeanによって公開されるすべての属性およびアクションの取得を許可する。