JavaTM 2 Platform
Standard Ed. 5.0

javax.management
インタフェース MBeanServerConnection

既知のサブインタフェースの一覧:
MBeanServer, MBeanServerForwarder

public interface MBeanServerConnection

このインタフェースは、MBean サーバ (ローカルまたはリモート) との通信方法を示します。ローカル MBean サーバを表す MBeanServer インタフェースによって拡張されます。

導入されたバージョン:
1.5

メソッドの概要
 void addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback)
          登録済み MBean にリスナーを追加します。
 void addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback)
          登録済み MBean にリスナーを追加します。
 ObjectInstance createMBean(String className, ObjectName name)
          MBean をインスタンス化し、MBean サーバに登録します。
 ObjectInstance createMBean(String className, ObjectName name, Object[] params, String[] signature)
          MBean をインスタンス化し、MBean サーバに登録します。
 ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName)
          MBean をインスタンス化し、MBean サーバに登録します。
 ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature)
          MBean をインスタンス化し、MBean サーバに登録します。
 Object getAttribute(ObjectName name, String attribute)
          指定された MBean の特定の属性の値を取得します。
 AttributeList getAttributes(ObjectName name, String[] attributes)
          指定された MBean の複数の属性の値を有効化します。
 String getDefaultDomain()
          MBean の指定に使用するデフォルトのドメインを返します。
 String[] getDomains()
          MBean が現在登録されているドメインのリストを返します。
 Integer getMBeanCount()
          MBean サーバに登録されている MBean の数を返します。
 MBeanInfo getMBeanInfo(ObjectName name)
          このメソッドは、MBean が管理用として公開している属性とオペレーションを検出します。
 ObjectInstance getObjectInstance(ObjectName name)
          MBean に登録された MBean の ObjectInstance を取得します。
 Object invoke(ObjectName name, String operationName, Object[] params, String[] signature)
          MBean上でオペレーションを呼び出します。
 boolean isInstanceOf(ObjectName name, String className)
          指定された MBean が指定されたクラスのインスタンスである場合は true、そうでない場合は false を返します。
 boolean isRegistered(ObjectName name)
          このオブジェクト名で識別される MBean が、すでに MBean サーバに登録されているかどうかをチェックします。
 Set queryMBeans(ObjectName name, QueryExp query)
          MBean サーバによって制御される MBean を取得します。
 Set queryNames(ObjectName name, QueryExp query)
          MBean サーバによって制御される MBean の名前を取得します。
 void removeNotificationListener(ObjectName name, NotificationListener listener)
          登録済み MBean からリスナーを削除します。
 void removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback)
          登録済み MBean からリスナーを削除します。
 void removeNotificationListener(ObjectName name, ObjectName listener)
          登録済み MBean からリスナーを削除します。
 void removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback)
          登録済み MBean からリスナーを削除します。
 void setAttribute(ObjectName name, Attribute attribute)
          指定された MBean の特定の属性の値を設定します。
 AttributeList setAttributes(ObjectName name, AttributeList attributes)
          指定された MBean の複数の属性の値を設定します。
 void unregisterMBean(ObjectName name)
          MBean サーバから MBean の登録を解除します。
 

メソッドの詳細

createMBean

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

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

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

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

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 クラス名を含む ObjectInstanceObjectNamen の場合、Java クラス名は getMBeanInfo(n).getClassName()
例外:
ReflectionException - MBean のコンストラクタの呼び出し時に発行される java.lang.ClassNotFoundException または java.lang.Exception をラップする場合
InstanceAlreadyExistsException - MBean がすでに MBean サーバによって制御されている場合
MBeanRegistrationException - MBean の preRegister (MBeanRegistration インタフェース) メソッドが例外をスローした場合。MBean は登録されない
MBeanException - MBean のコンストラクタが例外をスローした場合
NotCompliantMBeanException - このクラスが JMX 準拠の MBean でない場合
InstanceNotFoundException - 指定されたクラスローダが MBean サーバに登録されていない場合
RuntimeOperationsException - java.lang.IllegalArgumentException をラップする場合。つまり、パラメータに渡される className が null であるか、パラメータに渡される ObjectName がパターンであるか、MBean に ObjectName が指定されていない場合
IOException - MBean サーバとの通信時に発生した問題

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name,
                           Object[] params,
                           String[] signature)
                           throws ReflectionException,
                                  InstanceAlreadyExistsException,
                                  MBeanRegistrationException,
                                  MBeanException,
                                  NotCompliantMBeanException,
                                  IOException
MBean をインスタンス化し、MBean サーバに登録します。MBean サーバは、デフォルトのローダリポジトリを使って、この MBean のクラスをロードします。MBean にはオブジェクト名が関連付けられます。このオブジェクト名が null の場合、MBean は、MBeanRegistration インタフェースを実装し、preRegister メソッドから返される独自の名前を使用する必要があります。

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

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 クラス名を含む ObjectInstanceObjectNamen の場合、Java クラス名は getMBeanInfo(n).getClassName()
例外:
ReflectionException - MBean のコンストラクタの呼び出し時に発行される java.lang.ClassNotFoundException または java.lang.Exception をラップする場合
InstanceAlreadyExistsException - MBean がすでに MBean サーバによって制御されている場合
MBeanRegistrationException - MBean の preRegister (MBeanRegistration インタフェース) メソッドが例外をスローした場合。MBean は登録されない
MBeanException - MBean のコンストラクタが例外をスローした場合
NotCompliantMBeanException - このクラスが JMX 準拠の MBean でない場合
InstanceNotFoundException - 指定されたクラスローダが MBean サーバに登録されていない場合
RuntimeOperationsException - java.lang.IllegalArgumentException をラップする場合。つまり、パラメータに渡される className が null であるか、パラメータに渡される ObjectName がパターンであるか、MBean に ObjectName が指定されていない場合
IOException - MBean サーバとの通信時に発生した問題

unregisterMBean

void unregisterMBean(ObjectName name)
                     throws InstanceNotFoundException,
                            MBeanRegistrationException,
                            IOException
MBean サーバから MBean の登録を解除します。MBean はオブジェクト名で識別されます。メソッドを呼び出したあと、オブジェクト名を指定してこの MBean にアクセスすることはできません。

パラメータ:
name - 登録解除する MBean のオブジェクト名
例外:
InstanceNotFoundException - 指定された MBean が MBean サーバに登録されていない場合
MBeanRegistrationException - MBean の preDeregister (MBeanRegistration インタフェース) メソッドが例外をスローした場合
RuntimeOperationsException - java.lang.IllegalArgumentException をラップする場合。すなわち、パラメータ内のオブジェクト名が null であるか、登録解除しようとしている MBean が MBeanServerDelegate である場合
IOException - MBean サーバとの通信時に発生した問題

getObjectInstance

ObjectInstance getObjectInstance(ObjectName name)
                                 throws InstanceNotFoundException,
                                        IOException
MBean に登録された MBean の ObjectInstance を取得します。

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

queryMBeans

Set queryMBeans(ObjectName name,
                QueryExp query)
                throws IOException
MBean サーバによって制御される MBean を取得します。このメソッドは、すべての MBean、ObjectName や Query 式のパターンマッチングによって指定された MBean のセット、特定の MBean のいずれかを返します。オブジェクト名が null である場合、またはドメインやキーのプロパティが指定されていない場合、すべてのオブジェクトが選択されます。クエリーが指定されている場合は、さらにフィルタリングが適用されます。このメソッドは、選択された MBean に対して、ObjectInstance オブジェクトのセット (ObjectName と Java Class 名を含む) を返します。

パラメータ:
name - 取得する MBean を識別するオブジェクト名パターン。null の場合、またはドメインやキーのプロパティが指定されていない場合は、登録されているすべての MBean が取得される
query - MBean の選択に適用されるクエリー式。null の場合、MBean の選択にクエリー式は適用されない
戻り値:
選択された MBean の ObjectInstance オブジェクトを含むセット。クエリーの条件を満たす MBean が存在しない場合、空のリストが返される
例外:
IOException - MBean サーバとの通信時に発生した問題

queryNames

Set 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 サーバとの通信時に発生した問題

getAttribute

Object getAttribute(ObjectName name,
                    String attribute)
                    throws MBeanException,
                           AttributeNotFoundException,
                           InstanceNotFoundException,
                           ReflectionException,
                           IOException
指定された MBean の特定の属性の値を取得します。MBean はオブジェクト名で識別されます。

パラメータ:
name - MBean のオブジェクト名。この MBean の属性が取得される
attribute - 取得される属性の名前を指定する String
戻り値:
取得される属性の値
例外:
AttributeNotFoundException - MBean の指定された属性がアクセス不能である場合
MBeanException - MBean の取得メソッドによってスローされる例外をラップする場合
InstanceNotFoundException - 指定された MBean が MBean サーバに登録されていない場合
ReflectionException - 設定メソッドの呼び出し時にスローされる java.lang.Exception をラップする場合
RuntimeOperationsException - java.lang.IllegalArgumentException をラップする場合。すなわち、パラメータ内のオブジェクト名が null であるか、パラメータ内に属性が指定されていない場合
IOException - MBean サーバとの通信時に発生した問題
関連項目:
setAttribute(javax.management.ObjectName, javax.management.Attribute)

getAttributes

AttributeList getAttributes(ObjectName name,
                            String[] attributes)
                            throws InstanceNotFoundException,
                                   ReflectionException,
                                   IOException
指定された MBean の複数の属性の値を有効化します。MBean はオブジェクト名で識別されます。

パラメータ:
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)

setAttribute

void setAttribute(ObjectName name,
                  Attribute attribute)
                  throws InstanceNotFoundException,
                         AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException,
                         IOException
指定された MBean の特定の属性の値を設定します。MBean はオブジェクト名で識別されます。

パラメータ:
name - MBean 名。この MBean の属性が設定される
attribute - 設定される属性の ID と設定される値
例外:
InstanceNotFoundException - 指定された MBean が MBean サーバに登録されていない場合
AttributeNotFoundException - MBean の指定された属性がアクセス不能である場合
InvalidAttributeValueException - 指定された値が、属性に対する有効な値でない場合
MBeanException - MBean の設定メソッドによってスローされる例外をラップする場合
ReflectionException - 設定メソッドの呼び出し時にスローされる java.lang.Exception をラップする場合
RuntimeOperationsException - java.lang.IllegalArgumentException をラップする場合。すなわち、パラメータ内のオブジェクト名が null であるか、パラメータ内に属性が指定されていない場合
IOException - MBean サーバとの通信時に発生した問題
関連項目:
getAttribute(javax.management.ObjectName, java.lang.String)

setAttributes

AttributeList setAttributes(ObjectName name,
                            AttributeList attributes)
                            throws InstanceNotFoundException,
                                   ReflectionException,
                                   IOException
指定された MBean の複数の属性の値を設定します。MBean はオブジェクト名で識別されます。

パラメータ:
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上でオペレーションを呼び出します。

パラメータ:
name - メソッドの呼び出しが行われる MBean のオブジェクト名
operationName - 呼び出されるオペレーションの名前
params - オペレーションの呼び出し時に設定されるパラメータを含む配列
signature - オペレーションのシグニチャーを含む配列。クラスオブジェクトのロードには、オペレーションを呼び出した 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,
                             NotificationListener 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 名がない場合
IOException - MBean サーバとの通信時に発生した問題
関連項目:
removeNotificationListener(ObjectName, NotificationListener), removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

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)
                                throws InstanceNotFoundException,
                                       ListenerNotFoundException,
                                       IOException
登録済み MBean からリスナーを削除します。

リスナーが、別のフィルタまたはコールバックにより複数回登録された場合、このメソッドは、これらすべての登録を削除します。

パラメータ:
name - リスナーが削除される MBean の名前
listener - 削除されるリスナーのオブジェクト名
例外:
InstanceNotFoundException - 登録済み MBean の中に、指定された MBean 名がない場合
ListenerNotFoundException - リスナーが MBean に登録されていない場合
IOException - MBean サーバとの通信時に発生した問題
関連項目:
addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

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

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

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

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

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

removeNotificationListener

void removeNotificationListener(ObjectName name,
                                NotificationListener listener)
                                throws InstanceNotFoundException,
                                       ListenerNotFoundException,
                                       IOException

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

リスナーが、別のフィルタまたはコールバックにより複数回登録された場合、このメソッドは、これらすべての登録を削除します。

パラメータ:
name - リスナーが削除される MBean の名前
listener - 削除されるリスナーのオブジェクト名
例外:
InstanceNotFoundException - 登録済み MBean の中に、指定された MBean 名がない場合
ListenerNotFoundException - リスナーが MBean に登録されていない場合
IOException - MBean サーバとの通信時に発生した問題
関連項目:
addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

removeNotificationListener

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

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

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

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

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

getMBeanInfo

MBeanInfo getMBeanInfo(ObjectName name)
                       throws InstanceNotFoundException,
                              IntrospectionException,
                              ReflectionException,
                              IOException
このメソッドは、MBean が管理用として公開している属性とオペレーションを検出します。

パラメータ:
name - 分析対象の MBean の名前
戻り値:
MBeanInfo のインスタンス。この MBean のすべての属性とオペレーションの取得を許可する
例外:
IntrospectionException - An exception occurred during introspection.
InstanceNotFoundException - 指定された MBean が見つからなかった場合
ReflectionException - Dynamic MBean の getMBeanInfo メソッドの呼び出し時に例外が発生した場合
IOException - MBean サーバとの通信時に発生した問題

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 が N と className の両方を正常にロードし、最初のクラスから 2 番目のクラスを割り当てることができる場合、結果は true です。

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

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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。