javax.management

クラス MBeanServerNotification

java.lang.Object

java.util.EventObject

javax.management.Notification

javax.management.MBeanServerNotification

すべての実装されたインタフェース:

Serializable

public class MBeanServerNotification
extends Notification

MBean サーバーにより、MBeanServerDelegate MBean から発行される通知を表します。MBean サーバーは、MBean 登録型または MBean 登録解除型の通知を発行します。

MBeanServerNotification を受信するには、MBeanServer を表す MBean、MBeanServerDelegate にリスナーを登録する必要があります。MBeanServerDelegate の ObjectName は、JMImplementation:type=MBeanServerDelegate である MBeanServerDelegate.DELEGATE_NAME です。

次のコードは、MBean サーバー mbeanServer に MBean が登録または登録解除されるたびにメッセージを出力します。

 private static final NotificationListener printListener = new NotificationListener() {
     public void handleNotification(Notification n, Object handback) {
         if (!(n instanceof MBeanServerNotification)) {
             System.out.println("Ignored notification of class " + n.getClass().getName());
             return;
         }
         MBeanServerNotification mbsn = (MBeanServerNotification) n;
         String what;
         if (n.getType().equals(MBeanServerNotification.REGISTRATION_NOTIFICATION))
             what = "MBean registered";
         else if (n.getType().equals(MBeanServerNotification.UNREGISTRATION_NOTIFICATION))
             what = "MBean unregistered";
         else
             what = "Unknown type " + n.getType();
         System.out.println("Received MBean Server notification: " + what + ": " +
                 mbsn.getMBeanName());
     }
 };

 ...
     mbeanServer.addNotificationListener(
             MBeanServerDelegate.DELEGATE_NAME, printListener, null, null);
 

MBeanServerDelegate 以外の MBean も MBeanServerNotification を発行できます。特に、MBean が MBean のグループの MBeanServerNotification を発行する規則があります。

MBean のグループの登録または登録解除を示すために発行された MBeanServerNotification には、次の特徴があります。

• 通知型は "JMX.mbean.registered.group" または "JMX.mbean.unregistered.group" であり、通知型に REGISTRATION_NOTIFICATION+ ".group" または UNREGISTRATION_NOTIFICATION+ ".group" を書き込むこともできる。
• MBean 名は、登録または登録解除された MBean のセット (またはスーパーセット) を選択する ObjectName パターンである
• オプションで、ユーザーデータを、登録または登録解除されたすべての MBean の名前を含む ObjectName の配列に設定できる。

MBean グループの登録/登録解除の通知は、それを発行する MBean により MBeanNotificationInfo 内に宣言されます。

導入されたバージョン:

1.5

関連項目:

直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	REGISTRATION_NOTIFICATION MBean が登録されたことを示す通知型です。
static String	UNREGISTRATION_NOTIFICATION MBean の登録が解除されたことを示す通知型です。

クラス javax.management.Notification から継承されたフィールド

source

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
MBeanServerNotification(String type, Object source, long sequenceNumber, ObjectName objectName) 通知と指定の通知型を発行した MBean のオブジェクト名を指定する、MBeanServerNotification オブジェクトを作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
ObjectName	getMBeanName() 通知を発行した MBean のオブジェクト名を返します。
String	toString() この通知の String 表現を返します。

クラス javax.management.Notification から継承されたメソッド

getMessage, getSequenceNumber, getTimeStamp, getType, getUserData, setSequenceNumber, setSource, setTimeStamp, setUserData

クラス java.util.EventObject から継承されたメソッド

getSource

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールドの詳細

REGISTRATION_NOTIFICATION

public static final String REGISTRATION_NOTIFICATION

MBean が登録されたことを示す通知型です。値は「JMX.mbean.registered」になります。

関連項目:

定数フィールド値

UNREGISTRATION_NOTIFICATION

public static final String UNREGISTRATION_NOTIFICATION

MBean の登録が解除されたことを示す通知型です。値は「JMX.mbean.unregistered」になります。

関連項目:

定数フィールド値

コンストラクタの詳細

MBeanServerNotification

public MBeanServerNotification(String type,
                       Object source,
                       long sequenceNumber,
                       ObjectName objectName)

通知と指定の通知型を発行した MBean のオブジェクト名を指定する、MBeanServerNotification オブジェクトを作成します。

パラメータ:

type - 通知型を表す文字列。REGISTRATION_NOTIFICATION または UNREGISTRATION_NOTIFICATION に設定する。

source - MBean サーバー通知を転送する MBeanServerNotification オブジェクト。

sequenceNumber - 受信した通知の並べ替えに使用できるシーケンス番号。

objectName - 通知を発行した MBean のオブジェクト名。

メソッドの詳細

getMBeanName

public ObjectName getMBeanName()

通知を発行した MBean のオブジェクト名を返します。

戻り値:

通知を発行した MBean のオブジェクト名。

toString

public String toString()

クラスからコピーされた説明: Notification

この通知の String 表現を返します。

オーバーライド:

toString、クラス: Notification

戻り値:

この通知の String 表現。