- すべての実装されたインタフェース:
- DynamicMBean,- MBeanRegistration,- NotificationBroadcaster,- NotificationEmitter
Javaインタフェースのリフレクションによって管理インタフェースを決定し、通知を発行するMBeanです。
次の例は、publicコンストラクタStandardEmitterMBean(implementation, mbeanInterface, emitter)を使用して、任意の実装クラス名Impl、任意のインタフェースIntfで定義された管理インタフェース(現在のStandard MBean用)、およびインタフェースNotificationEmitterの任意の実装を指定し、通知を発行するMBeanを作成する方法を示しています。 この例では、NotificationBroadcasterSupportクラスをインタフェースNotificationEmitterの実装として使用します。 
     MBeanServer mbs;
     ...
     final String[] types = new String[] {"sun.disc.space","sun.disc.alarm"};
     final MBeanNotificationInfo info = new MBeanNotificationInfo(
                                          types,
                                          Notification.class.getName(),
                                          "Notification about disc info.");
     final NotificationEmitter emitter =
                    new NotificationBroadcasterSupport(info);
     final Intf impl = new Impl(...);
     final Object mbean = new StandardEmitterMBean(
                                     impl, Intf.class, emitter);
     mbs.registerMBean(mbean, objectName);
     - 導入されたバージョン:
- 1.6
- 関連項目:
- StandardMBean
- 
コンストラクタのサマリーコンストラクタ修飾子コンストラクタ説明protectedStandardEmitterMBean(Class<?> mbeanInterface, boolean isMXBean, NotificationEmitter emitter)管理インタフェースがmbeanInterfaceで指定されたMBeanを作成します。通知は、指定したNotificationEmitterにより処理されます。protectedStandardEmitterMBean(Class<?> mbeanInterface, NotificationEmitter emitter)管理インタフェースがmbeanInterfaceで指定されたMBeanを作成します。通知は、指定したNotificationEmitterにより処理されます。StandardEmitterMBean(T implementation, Class<T> mbeanInterface, boolean isMXBean, NotificationEmitter emitter)指定された実装を持ち、指定されたNotificationEmitterで通知が処理される、管理インタフェースがmbeanInterfaceで指定されたMBeanを作成します。StandardEmitterMBean(T implementation, Class<T> mbeanInterface, NotificationEmitter emitter)指定された実装を持ち、指定されたNotificationEmitterで通知が処理される、管理インタフェースがmbeanInterfaceで指定されたMBeanを作成します。
- 
メソッドのサマリー修飾子と型メソッド説明voidaddNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)このMBeanにリスナーを追加します。このMBeanが送信する可能性のある各通知について、その通知のJavaクラス名と通知タイプを示す配列を返します。voidremoveNotificationListener(NotificationListener listener)このMBeanからリスナーを削除します。voidremoveNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)このMBeanからリスナーを削除します。void通知を送信します。クラス javax.management.StandardMBeanで宣言されたメソッドcacheMBeanInfo, getAttribute, getAttributes, getCachedMBeanInfo, getClassName, getConstructors, getDescription, getDescription, getDescription, getDescription, getDescription, getDescription, getDescription, getImpact, getImplementation, getImplementationClass, getMBeanInfo, getMBeanInterface, getParameterName, getParameterName, invoke, postDeregister, postRegister, preDeregister, preRegister, setAttribute, setAttributes, setImplementation
- 
コンストラクタの詳細- 
StandardEmitterMBeanpublic StandardEmitterMBean(T implementation, Class<T> mbeanInterface, NotificationEmitter emitter)指定された実装を持ち、指定された NotificationEmitterで通知が処理される、管理インタフェースがmbeanInterfaceで指定されたMBeanを作成します。 生成されるMBeanは、そのメソッドをemitterに転送することにより、NotificationEmitterインタフェースを実装します。implementationおよびemitterを同じオブジェクトにすることは、正当で有用です。emitterがNotificationBroadcasterSupportのインスタンスである場合、MBeanのsendNotificationメソッドはemitter.sendNotificationを呼び出します。新規MBeanで getNotificationInfo()により返される配列は、構築時にemitter.getNotificationInfo()により返される配列のコピーです。emitter.getNotificationInfo()により返された配列があとで変更されても、オブジェクトのgetNotificationInfo()が影響を受けることはありません。- 型パラメータ:
- T- MBeanの実装型
- パラメータ:
- implementation- MBeanインタフェースの実装。
- mbeanInterface- Standard MBeanインタフェース。
- emitter- 通知を処理するオブジェクト。
- 例外:
- IllegalArgumentException-- mbeanInterfaceが管理インタフェースのJMX設計パターンに従っていない場合、指定された- implementationが指定されたインタフェースを実装していない場合、または- emitterがnullの場合。
 
- 
StandardEmitterMBeanpublic StandardEmitterMBean(T implementation, Class<T> mbeanInterface, boolean isMXBean, NotificationEmitter emitter)指定された実装を持ち、指定された NotificationEmitterで通知が処理される、管理インタフェースがmbeanInterfaceで指定されたMBeanを作成します。 このコンストラクタは、Standard MBeanまたはMXBeanの作成に使用できます。 生成されるMBeanは、そのメソッドをemitterに転送することにより、NotificationEmitterインタフェースを実装します。implementationおよびemitterを同じオブジェクトにすることは、正当で有用です。emitterがNotificationBroadcasterSupportのインスタンスである場合、MBeanのsendNotificationメソッドはemitter.sendNotificationを呼び出します。新規MBeanで getNotificationInfo()により返される配列は、構築時にemitter.getNotificationInfo()により返される配列のコピーです。emitter.getNotificationInfo()により返された配列があとで変更されても、オブジェクトのgetNotificationInfo()が影響を受けることはありません。- 型パラメータ:
- T- MBeanの実装型
- パラメータ:
- implementation- MBeanインタフェースの実装。
- mbeanInterface- Standard MBeanインタフェース。
- isMXBean- trueの場合、- mbeanInterfaceパラメータによりMXBeanインタフェースが指定され、結果のMBeanはMXBeanになる。
- emitter- 通知を処理するオブジェクト。
- 例外:
- IllegalArgumentException-- mbeanInterfaceが管理インタフェースのJMX設計パターンに従っていない場合、指定された- implementationが指定されたインタフェースを実装していない場合、または- emitterがnullの場合。
 
- 
StandardEmitterMBeanprotected StandardEmitterMBean(Class<?> mbeanInterface, NotificationEmitter emitter)管理インタフェースが mbeanInterfaceで指定されたMBeanを作成します。通知は、指定したNotificationEmitterにより処理されます。 生成されるMBeanは、そのメソッドをemitterに転送することにより、NotificationEmitterインタフェースを実装します。emitterがNotificationBroadcasterSupportのインスタンスである場合、MBeanのsendNotificationメソッドはemitter.sendNotificationを呼び出します。新規MBeanで getNotificationInfo()により返される配列は、構築時にemitter.getNotificationInfo()により返される配列のコピーです。emitter.getNotificationInfo()により返された配列があとで変更されても、オブジェクトのgetNotificationInfo()が影響を受けることはありません。このコンストラクタの呼出しは、指定した mbeanInterfaceを実装するサブクラスから行う必要があります。- パラメータ:
- mbeanInterface- StandardMBeanインタフェース。
- emitter- 通知を処理するオブジェクト。
- 例外:
- IllegalArgumentException-- mbeanInterfaceが管理インタフェースのJMX設計パターンに従っていない場合、- thisが指定されたインタフェースを実装していない場合、または- emitterがnullの場合。
 
- 
StandardEmitterMBeanprotected StandardEmitterMBean(Class<?> mbeanInterface, boolean isMXBean, NotificationEmitter emitter)管理インタフェースが mbeanInterfaceで指定されたMBeanを作成します。通知は、指定したNotificationEmitterにより処理されます。 このコンストラクタは、Standard MBeanまたはMXBeanの作成に使用できます。 生成されるMBeanは、そのメソッドをemitterに転送することにより、NotificationEmitterインタフェースを実装します。emitterがNotificationBroadcasterSupportのインスタンスである場合、MBeanのsendNotificationメソッドはemitter.sendNotificationを呼び出します。新規MBeanで getNotificationInfo()により返される配列は、構築時にemitter.getNotificationInfo()により返される配列のコピーです。emitter.getNotificationInfo()により返された配列があとで変更されても、オブジェクトのgetNotificationInfo()が影響を受けることはありません。このコンストラクタの呼出しは、指定した mbeanInterfaceを実装するサブクラスから行う必要があります。- パラメータ:
- mbeanInterface- StandardMBeanインタフェース。
- isMXBean- trueの場合、- mbeanInterfaceパラメータによりMXBeanインタフェースが指定され、結果のMBeanはMXBeanになる。
- emitter- 通知を処理するオブジェクト。
- 例外:
- IllegalArgumentException-- mbeanInterfaceが管理インタフェースのJMX設計パターンに従っていない場合、- thisが指定されたインタフェースを実装していない場合、または- emitterがnullの場合。
 
 
- 
- 
メソッドの詳細- 
removeNotificationListenerpublic void removeNotificationListener(NotificationListener listener) throws ListenerNotFoundExceptionインタフェースからコピーされた説明:NotificationBroadcasterこのMBeanからリスナーを削除します。 リスナーが別のハンドバック・オブジェクトまたは通知フィルタに登録されている場合、このリスナーに対応するすべてのエントリが削除されます。- 定義:
- removeNotificationListener、インタフェース:- NotificationBroadcaster
- パラメータ:
- listener- 以前にこのMBeanに追加されたリスナー。
- 例外:
- ListenerNotFoundException- リスナーがMBeanに登録されていない場合。
- 関連項目:
- NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object),- NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)
 
- 
removeNotificationListenerpublic void removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback) throws ListenerNotFoundExceptionインタフェースからコピーされた説明:NotificationEmitterこのMBeanからリスナーを削除します。 MBeanは、指定された listener、filter、およびhandbackパラメータと正確に一致するリスナーを持っている必要があります。 該当するリスナーが複数存在する場合、そのうちの1つだけが削除されます。削除されるリスナー内でnullが指定されている場合にのみ、 filterおよびhandbackパラメータはnullになります。- 定義:
- removeNotificationListener、インタフェース:- NotificationEmitter
- パラメータ:
- listener- 以前にこのMBeanに追加されたリスナー。
- filter- リスナーの追加時に指定されたフィルタ。
- handback- リスナーの追加時に指定されたハンドバック。
- 例外:
- ListenerNotFoundException- リスナーがMBeanに登録されていない場合、または指定されたフィルタおよびハンドバックで登録されていない場合。
 
- 
addNotificationListenerpublic void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)インタフェースからコピーされた説明:NotificationBroadcasterこのMBeanにリスナーを追加します。- 定義:
- addNotificationListener、インタフェース:- NotificationBroadcaster
- パラメータ:
- listener- ブロードキャスタが発行した通知を処理するリスナー・オブジェクト。
- filter- フィルタ・オブジェクト。 フィルタがnullの場合、通知処理の前にフィルタは適用されない。
- handback- 通知の発行時にリスナーに送信される不透明なオブジェクト。 Notificationブロードキャスタ・オブジェクトは、このオブジェクトを使用できない。 このオブジェクトは、手を加えない状態で、通知とともにリスナーへ送り返されなければならない。
- 関連項目:
- NotificationBroadcaster.removeNotificationListener(javax.management.NotificationListener)
 
- 
getNotificationInfopublic MBeanNotificationInfo[] getNotificationInfo()インタフェースからコピーされた説明:NotificationBroadcasterこのMBeanが送信する可能性のある各通知について、その通知のJavaクラス名と通知タイプを示す配列を返します。 この配列に記述されていない通知をMBeanが送信しても、不正ではありません。 ただし一部のMBeanサーバー・クライアントは、正しく機能するために、作成される配列に依存する場合があります。 - 定義:
- getNotificationInfo、インタフェース:- NotificationBroadcaster
- 戻り値:
- 可能な通知の配列。
 
- 
sendNotificationpublic void sendNotification(Notification n)通知を送信します。 コンストラクタに渡される emitterパラメータがNotificationBroadcasterSupportのインスタンスであった場合、このメソッドはemitter.sendNotificationを呼び出します。- パラメータ:
- n- 送信する通知。
- 例外:
- ClassCastException- コンストラクタに渡される- emitterパラメータが- NotificationBroadcasterSupportでなかった場合。
 
 
-