JavaTM 2 Platform
Standard Ed. 5.0

javax.management
インタフェース NotificationBroadcaster

既知のサブインタフェースの一覧:
ModelMBean, ModelMBeanNotificationBroadcaster, NotificationEmitter
既知の実装クラスの一覧:
CounterMonitor, GaugeMonitor, JMXConnectorServer, MBeanServerDelegate, Monitor, NotificationBroadcasterSupport, RelationService, RequiredModelMBean, RMIConnectorServer, StringMonitor, Timer

public interface NotificationBroadcaster

Notification を発行する MBean が実装しているインタフェース。このインタフェースにより、リスナーを通知リスナーとして MBean に登録できます。

新しいコードは、NotificationEmitter インタフェースを使用する必要があります。

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

メソッドの概要
 void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
          この MBean にリスナーを追加します。
 MBeanNotificationInfo[] getNotificationInfo()
          この MBean が通知を送信するたびに、その通知の Java クラス名と通知型を示す配列を返します。
 void removeNotificationListener(NotificationListener listener)
          この MBean からリスナーを削除します。
 

メソッドの詳細

addNotificationListener

void addNotificationListener(NotificationListener listener,
                             NotificationFilter filter,
                             Object handback)
                             throws IllegalArgumentException
この MBean にリスナーを追加します。

パラメータ:
listener - ブロードキャスタが発行した通知を処理するリスナーオブジェクト
filter - フィルタオブジェクト。フィルタが null の場合、通知処理の前にフィルタは適用されない
handback - 通知の発行時にリスナーに送信される不透明なオブジェクト。Notification ブロードキャスタオブジェクトは、このオブジェクトを使用できない。このオブジェクトは、手を加えない状態で、通知からリスナーへ送り返されなければならない
例外:
IllegalArgumentException - リスナーパラメータが null の場合
関連項目:
removeNotificationListener(javax.management.NotificationListener)

removeNotificationListener

void removeNotificationListener(NotificationListener listener)
                                throws ListenerNotFoundException
この MBean からリスナーを削除します。リスナーが別のハンドバックオブジェクトまたは通知フィルタに登録されている場合、このリスナーに対応するすべてのエントリが削除されます。

パラメータ:
listener - 以前にこの MBean に追加されたリスナー
例外:
ListenerNotFoundException - リスナーが MBean に登録されていない場合
関連項目:
addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object), NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

getNotificationInfo

MBeanNotificationInfo[] getNotificationInfo()

この MBean が通知を送信するたびに、その通知の Java クラス名と通知型を示す配列を返します。

MBean が、この配列に記述されていない通知を送信することはできません。ただし、一部の 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 も参照してください。