モジュール java.management
パッケージ javax.management

インタフェースMBeanServerConnection

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

    public interface MBeanServerConnection
    このインタフェースは、MBeanサーバー(ローカルまたはリモート)との通信方法を示します。 ローカルMBeanサーバーを表すMBeanServerインタフェースはこのインタフェースを拡張します。
    導入されたバージョン:
    1.5

    • メソッドの詳細

      • createMBean

        ObjectInstance createMBean​(String className,
                           ObjectName name)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           IOException

        MBeanをインスタンス化し、MBeanサーバーに登録します。 MBeanサーバーは、Default Loader Repositoryを使って、このMBeanのクラスをロードします。 MBeanにはオブジェクト名が関連付けられます。 このオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。

        このメソッドは、createMBean(className, name,(Object[]) null,(String[]) null)と同等です。

        パラメータ:
        className - インスタンス化するMBeanのクラス名。
        name - MBeanのオブジェクト名。 nullも可。
        戻り値:
        新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。
        例外:
        ReflectionException - MBeanのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。
        InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。
        MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。
        RuntimeMBeanException - MBeanのコンストラクタ、あるいはそのpreRegisterまたはpostRegisterメソッドがRuntimeExceptionをスローした場合。 MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。
        RuntimeErrorException - MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。
        MBeanException - MBeanのコンストラクタが例外をスローした場合
        NotCompliantMBeanException - このクラスがJMX準拠のMBeanでない場合
        RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullであるか、パラメータに渡されるObjectNameがパターンであるか、MBeanにObjectNameが指定されていない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        MBeanRegistration

      • createMBean

        ObjectInstance createMBean​(String className,
                           ObjectName name,
                           ObjectName loaderName)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           InstanceNotFoundException,
                           IOException

        MBeanをインスタンス化し、MBeanサーバーに登録します。 使用するクラス・ローダーは、オブジェクト名で識別されます。 MBeanにはオブジェクト名が関連付けられます。 ローダーのオブジェクト名がnullの場合、MBeanサーバーのロードに使用したClassLoaderが使用されます。 MBeanのオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。

        このメソッドは、createMBean(className, name, loaderName,(Object[]) null,(String[]) null)と同等です。

        パラメータ:
        className - インスタンス化するMBeanのクラス名。
        name - MBeanのオブジェクト名。 nullも可。
        loaderName - 使用するクラス・ローダーのオブジェクト名。
        戻り値:
        新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。
        例外:
        ReflectionException - MBeanのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。
        InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。
        MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。
        RuntimeMBeanException - MBeanのコンストラクタ、あるいはそのpreRegisterまたはpostRegisterメソッドがRuntimeExceptionをスローした場合。 MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。
        RuntimeErrorException - MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。
        MBeanException - MBeanのコンストラクタが例外をスローした場合
        NotCompliantMBeanException - このクラスがJMX準拠のMBeanでない場合
        InstanceNotFoundException - 指定されたクラス・ローダーがMBeanサーバーに登録されていない場合。
        RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullであるか、パラメータに渡されるObjectNameがパターンであるか、MBeanにObjectNameが指定されていない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        MBeanRegistration

      • createMBean

        ObjectInstance createMBean​(String className,
                           ObjectName name,
                           Object[] params,
                           String[] signature)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           IOException
        MBeanをインスタンス化し、MBeanサーバーに登録します。 MBeanサーバーは、Default Loader Repositoryを使って、このMBeanのクラスをロードします。 MBeanにはオブジェクト名が関連付けられます。 このオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。
        パラメータ:
        className - インスタンス化するMBeanのクラス名。
        name - MBeanのオブジェクト名。 nullも可。
        params - 呼び出されるコンストラクタのパラメータを含む配列。
        signature - 呼び出されるコンストラクタのシグニチャを含む配列。
        戻り値:
        新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。
        例外:
        ReflectionException - MBeanのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。
        InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。
        MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。
        RuntimeMBeanException - MBeanのコンストラクタ、あるいはそのpreRegisterまたはpostRegisterメソッドがRuntimeExceptionをスローした場合。 MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。
        RuntimeErrorException - MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。
        MBeanException - MBeanのコンストラクタが例外をスローした場合
        NotCompliantMBeanException - このクラスがJMX準拠のMBeanでない場合
        RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullであるか、パラメータに渡されるObjectNameがパターンであるか、MBeanにObjectNameが指定されていない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        MBeanRegistration

      • createMBean

        ObjectInstance createMBean​(String className,
                           ObjectName name,
                           ObjectName loaderName,
                           Object[] params,
                           String[] signature)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           InstanceNotFoundException,
                           IOException

        MBeanをインスタンス化し、MBeanサーバーに登録します。 使用するクラス・ローダーは、オブジェクト名で識別されます。 MBeanにはオブジェクト名が関連付けられます。 ローダーのオブジェクト名が指定されていない場合、MBeanサーバーのロードに使用したClassLoaderが使用されます。 MBeanのオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。

        パラメータ:
        className - インスタンス化するMBeanのクラス名。
        name - MBeanのオブジェクト名。 nullも可。
        params - 呼び出されるコンストラクタのパラメータを含む配列。
        signature - 呼び出されるコンストラクタのシグニチャを含む配列。
        loaderName - 使用するクラス・ローダーのオブジェクト名。
        戻り値:
        新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。
        例外:
        ReflectionException - MBeanのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。
        InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。
        MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。
        RuntimeMBeanException - MBeanのコンストラクタ、あるいはそのpreRegisterまたはpostRegisterメソッドがRuntimeExceptionをスローした場合。 MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。
        RuntimeErrorException - MBeanのpostRegisterメソッド(MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。
        MBeanException - MBeanのコンストラクタが例外をスローした場合
        NotCompliantMBeanException - このクラスがJMX準拠のMBeanでない場合
        InstanceNotFoundException - 指定されたクラス・ローダーがMBeanサーバーに登録されていない場合。
        RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullであるか、パラメータに渡されるObjectNameがパターンであるか、MBeanにObjectNameが指定されていない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        MBeanRegistration

      • unregisterMBean

        void unregisterMBean​(ObjectName name)
              throws InstanceNotFoundException,
                     MBeanRegistrationException,
                     IOException
        MBeanサーバーからMBeanの登録を解除します。 MBeanはオブジェクト名で識別されます。 メソッドを呼び出したあと、オブジェクト名を指定してこのMBeanにアクセスすることはできません。
        パラメータ:
        name - 登録解除するMBeanのオブジェクト名。
        例外:
        InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。
        MBeanRegistrationException - MBeanのpreDeregister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。
        RuntimeMBeanException - MBeanのpostDeregister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの登録解除は成功しますが、unregisterMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、unregisterMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録解除されます。 RuntimeMBeanExceptionはpreDeregisterでもスローされますが、その場合はMBeanの登録は解除されません。
        RuntimeErrorException - MBeanのpostDeregister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの登録解除は成功しますが、unregisterMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、unregisterMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録解除されます。 RuntimeMBeanExceptionはpreDeregisterでもスローされますが、その場合はMBeanの登録は解除されません。
        RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullであるか、登録解除しようとしているMBeanがMBeanServerDelegateである場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        MBeanRegistration

      • getObjectInstance

        ObjectInstance getObjectInstance​(ObjectName name)
                          throws InstanceNotFoundException,
                                 IOException
        MBeanに登録された、指定されたMBeanのObjectInstanceを取得します。
        パラメータ:
        name - MBeanのオブジェクト名。
        戻り値:
        nameで指定されたMBeanに関連付けられたObjectInstance。 含まれるObjectNameはnameで、含まれるクラス名はgetMBeanInfo(name).getClassName()。
        例外:
        InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。

      • queryMBeans

        Set<ObjectInstance> queryMBeans​(ObjectName name,
                                QueryExp query)
                         throws IOException
        MBeanサーバーによって制御されるMBeanを取得します。 このメソッドは、すべてのMBean、ObjectNameやクエリー式のパターン・マッチングによって指定されたMBeanのセット、特定のMBeanのいずれかを返します。 オブジェクト名がnullである場合、またはドメインやキーのプロパティが指定されていない場合、すべてのオブジェクトが選択されます。クエリーが指定されている場合は、さらにフィルタリングが適用されます。 このメソッドは、選択されたMBeanに対して、ObjectInstanceオブジェクトのセット(ObjectNameとJavaクラス名を含む)を返します。
        パラメータ:
        name - 取得するMBeanを識別するオブジェクト名パターン。 nullの場合、またはドメインやキーのプロパティが指定されていない場合は、登録されているすべてのMBeanが取得される。
        query - MBeanの選択に適用されるクエリー式。 nullの場合、MBeanの選択にクエリー式は適用されない。
        戻り値:
        選択されたMBeanのObjectInstanceオブジェクトを含むセット。 クエリーの条件を満たすMBeanが存在しない場合、空のリストが返される。
        例外:
        IOException - MBeanサーバーとの通信時に問題が発生した場合。

      • queryNames

        Set<ObjectName> queryNames​(ObjectName name,
                           QueryExp query)
                    throws IOException
        MBeanサーバーによって制御されるMBeanの名前を取得します。 このメソッドは、すべてのMBeanの名前、ObjectNameやQuery式のパターン・マッチングによって指定されたMBeanのセットの名前、特定のMBeanの名前のいずれかを返します。これにより、MBeanが登録されているかどうかを判別できます。 オブジェクト名がnullである場合、またはドメインやキーのプロパティが指定されていない場合、すべてのオブジェクトが選択されます。クエリーが指定されている場合は、さらにフィルタリングが適用されます。 このメソッドは、選択されたMBeanに対して、ObjectNameのセットを返します。
        パラメータ:
        name - 取得するMBean名を識別するオブジェクト名パターン。 nullの場合、またはドメインやキーのプロパティが指定されていない場合は、登録されているすべてのMBeanの名前が取得される。
        query - MBeanの選択に適用されるクエリー式。 nullの場合、MBeanの選択にクエリー式は適用されない。
        戻り値:
        選択されたMBeanのObjectNameを含むセット。 クエリーの条件を満たすMBeanが存在しない場合、空のリストが返される。
        例外:
        IOException - MBeanサーバーとの通信時に問題が発生した場合。

      • isRegistered

        boolean isRegistered​(ObjectName name)
              throws IOException
        このオブジェクト名で識別されるMBeanが、すでにMBeanサーバーに登録されているかどうかをチェックします。
        パラメータ:
        name - チェック対象のMBeanのオブジェクト名。
        戻り値:
        MBeanがすでにMBeanサーバーに登録されている場合はtrue、そうでない場合はfalse。
        例外:
        RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullの場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。

      • getMBeanCount

        Integer getMBeanCount​()
               throws IOException
        MBeanサーバーに登録されているMBeanの数を返します。
        戻り値:
        登録済みのMBeanの数。
        例外:
        IOException - MBeanサーバーとの通信時に問題が発生した場合。

      • getAttributes

        AttributeList getAttributes​(ObjectName name,
                            String[] attributes)
                     throws InstanceNotFoundException,
                            ReflectionException,
                            IOException

        指定されたMBeanの複数の属性の値を取り出します。 MBeanはオブジェクト名で識別されます。

        何らかの理由で1つ以上の属性を取得できない場合、それらは返されるAttributeListから省略されます。 呼出し側はリストがattributes配列と同じサイズであることを確認する必要があります。 属性の取得を妨げた問題を見つけるには、その属性のgetAttributeを呼び出します。

        このメソッドを呼び出して、要求されたすべての属性を正常に取得できたことを確認する例を次に示します。

         String[] attrNames = ...;
 AttributeList list = mbeanServerConnection.getAttributes(objectName, attrNames);
 if (list.size() == attrNames.length)
     System.out.println("All attributes were retrieved successfully");
 else {
     List<String> missing = new ArrayList<String>(Arrays.asList(attrNames));
     for (Attribute a : list.asList())
         missing.remove(a.getName());
     System.out.println("Did not retrieve: " + missing);
 }
        パラメータ:
        name - MBeanのオブジェクト名。このMBeanの属性が取得される。
        attributes - 取得される属性のリスト。
        戻り値:
        取得される属性のリスト。
        例外:
        InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。
        ReflectionException - Dynamic MBeanのgetAttributesメソッドの呼出し時に例外が発生した場合。
        RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullであるか、パラメータ内の属性がnullである場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        setAttributes(javax.management.ObjectName, javax.management.AttributeList)

      • setAttributes

        AttributeList setAttributes​(ObjectName name,
                            AttributeList attributes)
                     throws InstanceNotFoundException,
                            ReflectionException,
                            IOException

        指定されたMBeanの複数の属性の値を設定します。 MBeanはオブジェクト名で識別されます。

        何らかの理由で1つ以上の属性を設定できない場合、それらは返されるAttributeListから省略されます。 呼出し側は入力のAttributeListが出力のそれと同じサイズであることを確認する必要があります。 属性の取得を妨げた問題の発見は、通常、その属性のsetAttributeを呼び出すことで可能ですが、必ずしも成功する保証はありません。 たとえば、2つの属性の値が互いに矛盾するために拒否された可能性があります。 どちらか1つであれば、設定できる可能性があります。

        このメソッドを呼び出して、要求されたすべての属性を正常に設定できたことを確認する例を次に示します。

         AttributeList inputAttrs = ...;
 AttributeList outputAttrs = mbeanServerConnection.setAttributes(objectName, inputAttrs);
 if (inputAttrs.size() == outputAttrs.size())
     System.out.println("All attributes were set successfully");
 else {
     List<String> missing = new ArrayList<String>();
     for (Attribute a : inputAttrs.asList())
         missing.add(a.getName());
     for (Attribute a : outputAttrs.asList())
         missing.remove(a.getName());
     System.out.println("Did not set: " + missing);
 }
        パラメータ:
        name - MBeanのオブジェクト名。このMBeanの属性が設定される。
        attributes - 属性のリスト。属性のリスト(設定される属性のIDと設定される値)。
        戻り値:
        設定された属性と新しい値のリスト。
        例外:
        InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。
        ReflectionException - Dynamic MBeanのgetAttributesメソッドの呼出し時に例外が発生した場合。
        RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullであるか、パラメータ内の属性がnullである場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        getAttributes(javax.management.ObjectName, java.lang.String[])

      • invoke

        Object invoke​(ObjectName name,
              String operationName,
              Object[] params,
              String[] signature)
       throws InstanceNotFoundException,
              MBeanException,
              ReflectionException,
              IOException

        MBean上でオペレーションを呼び出します。

        オーバーロードされる可能性があるオペレーションを区別するためにsignatureが必要であるため、可能な場合は、MBeanプロキシを介してさらに簡単にオペレーションを呼び出すことができます。 たとえば、次のようなStandard MBeanインタフェースが存在する場合を考えましょう。 

         public interface FooMBean {
     public int countMatches(String[] patterns, boolean ignoreCase);
 }

        countMatchesオペレーションは次のようにして呼び出すことができます。

         String[] myPatterns = ...;
 int count = (Integer) mbeanServerConnection.invoke(
         objectName,
         "countMatches",
         new Object[] {myPatterns, true},
         new String[] {String[].class.getName(), boolean.class.getName()});

        または、次のようにプロキシを介して呼び出すこともできます。

         String[] myPatterns = ...;
 FooMBean fooProxy = JMX.newMBeanProxy(
         mbeanServerConnection, objectName, FooMBean.class);
 int count = fooProxy.countMatches(myPatterns, true);
        パラメータ:
        name - メソッドの呼出しが行われるMBeanのオブジェクト名。
        operationName - 呼び出されるオペレーションの名前。
        params - オペレーションの呼出し時に設定されるパラメータを含む配列。
        signature - オペレーションのシグニチャを含む配列(Class.getName()から返される形式のクラス名の配列)。 クラス・オブジェクトのロードには、オペレーションを呼び出したMBeanをロードするときと同じクラス・ローダーが使用される。
        戻り値:
        オペレーションによって返されるオブジェクト。指定されたMBean上でオペレーションを呼び出した結果を表す。
        例外:
        InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。
        MBeanException - MBeanの呼出しメソッドによってスローされる例外をラップする場合。
        ReflectionException - メソッドの呼出し時にスローされるjava.lang.Exceptionをラップする場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。

      • getDefaultDomain

        String getDefaultDomain​()
                 throws IOException
        MBeanの指定に使用するデフォルトのドメインを返します。 ユーザーがドメイン名を指定しなかった場合、MBeanのObjectNameのドメイン部分には、デフォルトのドメイン名が入ります。
        戻り値:
        デフォルトのドメイン。
        例外:
        IOException - MBeanサーバーとの通信時に問題が発生した場合。

      • getDomains

        String[] getDomains​()
             throws IOException

        MBeanが現在登録されているドメインのリストを返します。 返される配列内に文字列が含まれるのは、その文字列と等しいgetDomain()を持つObjectNameに1個以上のMBeanが登録されている場合だけです。 返される配列内の文字列の順序は未定義です。

        戻り値:
        ドメインのリスト。
        例外:
        IOException - MBeanサーバーとの通信時に問題が発生した場合。

      • addNotificationListener

        void addNotificationListener​(ObjectName name,
                             ObjectName listener,
                             NotificationFilter filter,
                             Object handback)
                      throws InstanceNotFoundException,
                             IOException

        登録済みMBeanにリスナーを追加します。

        MBeanが発行した通知は、MBeanServerによってリスナーに転送されます。 通知のソースがMBeanオブジェクトの参照になっている場合、MBeanサーバーは、これをMBeanのObjectNameで置き換えます。 それ以外の場合、ソースが変更されることはありません。

        通知を受け取るリスナー・オブジェクトは、このメソッドの呼出し時に指定された名前で登録されたリスナー・オブジェクトです。 その後は登録しなくても引き続き通知を受け取ります。

        パラメータ:
        name - リスナーが追加されるMBeanの名前。
        listener - 登録済みMBeanが発行した通知を処理するリスナーのオブジェクト名。
        filter - フィルタ・オブジェクト。 フィルタがnullの場合、通知処理の前にフィルタは適用されない。
        handback - 通知が発行されたときリスナーに送信されるコンテキスト。
        例外:
        InstanceNotFoundException - 登録済みMBeanの中に、通知リスナーまたは通知ブロードキャスタのMBean名がない場合。
        RuntimeOperationsException - IllegalArgumentExceptionをラップする場合。 listenerによって指定されたMBeanが存在していても、NotificationListenerインタフェースを実装していない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        removeNotificationListener(ObjectName, ObjectName), removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

      • removeNotificationListener

        void removeNotificationListener​(ObjectName name,
                                ObjectName listener,
                                NotificationFilter filter,
                                Object handback)
                         throws InstanceNotFoundException,
                                ListenerNotFoundException,
                                IOException

        登録済みMBeanからリスナーを削除します。

        MBeanは、指定されたlistener、filter、およびhandbackパラメータと正確に一致するリスナーを持っている必要があります。 該当するリスナーが複数存在する場合、そのうちの1つだけが削除されます。

        削除されるリスナー内でnullが指定されている場合にのみ、filterおよびhandbackパラメータはnullになります。

        パラメータ:
        name - リスナーが削除されるMBeanの名前。
        listener - 削除されるリスナーのオブジェクト名。
        filter - リスナーの追加時に指定されたフィルタ。
        handback - リスナーの追加時に指定されたハンドバック。
        例外:
        InstanceNotFoundException - 登録済みMBeanの中に、指定されたMBean名がない場合。
        ListenerNotFoundException - リスナーがMBeanに登録されていない場合、または指定されたフィルタおよびハンドバックで登録されていない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

      • removeNotificationListener

        void removeNotificationListener​(ObjectName name,
                                NotificationListener listener,
                                NotificationFilter filter,
                                Object handback)
                         throws InstanceNotFoundException,
                                ListenerNotFoundException,
                                IOException

        登録済みMBeanからリスナーを削除します。

        MBeanは、指定されたlistener、filter、およびhandbackパラメータと正確に一致するリスナーを持っている必要があります。 該当するリスナーが複数存在する場合、そのうちの1つだけが削除されます。

        削除されるリスナー内でnullが指定されている場合にのみ、filterおよびhandbackパラメータはnullになります。

        パラメータ:
        name - リスナーが削除されるMBeanの名前。
        listener - 削除されるリスナー。
        filter - リスナーの追加時に指定されたフィルタ。
        handback - リスナーの追加時に指定されたハンドバック。
        例外:
        InstanceNotFoundException - 登録済みMBeanの中に、指定されたMBean名がない場合。
        ListenerNotFoundException - リスナーがMBeanに登録されていない場合、または指定されたフィルタおよびハンドバックで登録されていない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

      • isInstanceOf

        boolean isInstanceOf​(ObjectName name,
                     String className)
              throws InstanceNotFoundException,
                     IOException

        指定されたMBeanが指定されたクラスのインスタンスである場合はtrue、そうでない場合はfalseを返します。

        nameがMBeanを指定していない場合、このメソッドはInstanceNotFoundExceptionをスローします。

        それ以外の場合、
        Xはnameで指定されたMBean、
        LはXのClassLoader、
        NはXのMBeanInfo内のクラス名になります。

        NがclassNameと等しい場合、結果はtrueです。

        それ以外の場合、LがclassNameを正常にロードし、Xがこのクラスのインスタンスである場合、結果はtrueです。

        それ以外の場合、LがNとclassNameの両方を正常にロードし、最初のクラスから2番目のクラスを割り当てることができる場合、結果はtrueです。

        それ以外の場合、結果はfalseです。

        パラメータ:
        name - MBeanのObjectName。
        className - クラスの名前。
        戻り値:
        上記の規則に従って、指定されたMBeanが指定されたクラスのインスタンスである場合はtrue、そうでない場合はfalse。
        例外:
        InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。
        IOException - MBeanサーバーとの通信時に問題が発生した場合。
        関連項目:
        Class.isInstance(java.lang.Object)