- java.lang.Object
- 
- javax.management.NotificationBroadcasterSupport
- 
- javax.management.monitor.Monitor
 
 
- 
- すべての実装されたインタフェース:
- MBeanRegistration,- MonitorMBean,- NotificationBroadcaster,- NotificationEmitter
 - 直系の既知のサブクラス:
- CounterMonitor,- GaugeMonitor,- StringMonitor
 
 
 public abstract class Monitor extends NotificationBroadcasterSupport implements MonitorMBean, MBeanRegistration すべてのモニターMBeanに共通な部分を定義します。 モニターMBeanは、監視対象のMBeanのセットに共通の属性の値を監視します。 監視対象の属性は、粒度周期として指定された間隔で監視されます。 ゲージ値(派生ゲージ)は、監視対象の属性の値から派生します。- 導入されたバージョン:
- 1.5
 
- 
- 
フィールドのサマリーフィールド 修飾子と型 フィールド 説明 protected intalreadyNotified非推奨。alreadyNotifieds[0]と同等です。protected int[]alreadyNotifiedsすでに通知された選択済みモニター・エラーです。protected static intcapacityIncrementモニター配列のサイズが容量より大きくなったとき自動的に増加する容量です。protected StringdbgTag非推奨。代替はありません。protected intelementCount監視対象のオブジェクトのベクトル内の有効なコンポーネントの数です。protected static intOBSERVED_ATTRIBUTE_ERROR_NOTIFIED監視対象の属性の変更後、通知が発行されたことを示すフラグです。protected static intOBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED監視対象のオブジェクトまたは属性の変更後、通知が発行されたことを示すフラグです。protected static intOBSERVED_OBJECT_ERROR_NOTIFIED監視対象のオブジェクトの変更後、通知が発行されたことを示すフラグです。protected static intRESET_FLAGS_ALREADY_NOTIFIEDこのフラグは、モニター属性alreadyNotifiedsをリセットするために使用されます。protected static intRUNTIME_ERROR_NOTIFIED監視対象のオブジェクトまたは属性の変更後、通知が発行されたことを示すフラグです。protected MBeanServerserverMBeanサーバーへの参照です。
 - 
コンストラクタのサマリーコンストラクタ コンストラクタ 説明 Monitor()
 - 
メソッドのサマリーすべてのメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 非推奨メソッド 修飾子と型 メソッド 説明 voidaddObservedObject(ObjectName object)監視対象のMBeanのセットに指定されたオブジェクトが含まれない場合、そのオブジェクトを追加します。booleancontainsObservedObject(ObjectName object)監視対象のMBeanのセット内に指定されたオブジェクトが含まれるかどうかをテストします。longgetGranularityPeriod()粒度周期(ミリ秒単位)を取得します。StringgetObservedAttribute()監視対象の属性を取得します。ObjectNamegetObservedObject()非推奨。JMX 1.2以降は、getObservedObjects()に置き換えられています。ObjectName[]getObservedObjects()監視対象のオブジェクトを含む配列を返します。booleanisActive()モニターMBeanがアクティブかどうかをテストします。voidpostDeregister()MBeanサーバーから登録解除したあと、モニターMBeanが必要なオペレーションを実行できるようにします。voidpostRegister(Boolean registrationDone)MBeanサーバーへの登録が成功または失敗したあと、モニターMBeanが必要なオペレーションを実行できるようにします。voidpreDeregister()MBeanサーバーから登録解除する前に、モニターMBeanが必要なオペレーションを実行できるようにします。ObjectNamepreRegister(MBeanServer server, ObjectName name)MBeanサーバーに登録する前に必要なオペレーションをモニターMBeanが実行することを許可します。voidremoveObservedObject(ObjectName object)監視対象のMBeanのセットから指定されたオブジェクトを削除します。voidsetGranularityPeriod(long period)粒度周期をミリ秒単位で設定します。voidsetObservedAttribute(String attribute)監視対象の属性を設定します。voidsetObservedObject(ObjectName object)非推奨。JMX 1.2以降は、addObservedObject(javax.management.ObjectName)に置き換えられています。abstract voidstart()モニターを開始します。abstract voidstop()モニターを停止します。- 
クラス javax.management.NotificationBroadcasterSupportから継承されたメソッドaddNotificationListener, getNotificationInfo, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification
 
- 
 
- 
- 
- 
フィールドの詳細- 
capacityIncrementprotected static final int capacityIncrement モニター配列のサイズが容量より大きくなったとき自動的に増加する容量です。- 関連項目:
- 定数フィールド値
 
 - 
elementCountprotected int elementCount 監視対象のオブジェクトのベクトル内の有効なコンポーネントの数です。
 - 
alreadyNotified@Deprecated protected int alreadyNotified 非推奨。alreadyNotifieds[0]と同等です。すでに通知されたモニター・エラーです。
 - 
alreadyNotifiedsprotected int[] alreadyNotifieds すでに通知された選択済みモニター・エラーです。 この配列内の各要素は、ベクトル内の監視対象オブジェクトに対応しています。 OBSERVED_OBJECT_ERROR_NOTIFIEDフラグなどのビット・マスクを含み、対応する通知がすでに監視対象のMBeanに送信されたかどうかを示します。
 - 
serverprotected MBeanServer server MBeanサーバーへの参照です。 この参照は、モニターMBeanがMBeanサーバーに登録されていない場合nullになります。 モニターMBeanがMBeanに登録される前に初期化されます。
 - 
RESET_FLAGS_ALREADY_NOTIFIEDprotected static final int RESET_FLAGS_ALREADY_NOTIFIED このフラグは、モニター属性alreadyNotifiedsをリセットするために使用されます。- 関連項目:
- 定数フィールド値
 
 - 
OBSERVED_OBJECT_ERROR_NOTIFIEDprotected static final int OBSERVED_OBJECT_ERROR_NOTIFIED 監視対象のオブジェクトの変更後、通知が発行されたことを示すフラグです。 このフラグは、最初の通知の発行時にMBeanサーバーに新しい監視対象オブジェクトが登録されたことを確認するために使用されます。- 関連項目:
- 定数フィールド値
 
 - 
OBSERVED_ATTRIBUTE_ERROR_NOTIFIEDprotected static final int OBSERVED_ATTRIBUTE_ERROR_NOTIFIED 監視対象の属性の変更後、通知が発行されたことを示すフラグです。 このフラグは、最初の通知の発行時に新しい監視対象の属性が監視対象のオブジェクトに所属することを確認するために使用されます。- 関連項目:
- 定数フィールド値
 
 - 
OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIEDprotected static final int OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED 監視対象のオブジェクトまたは属性の変更後、通知が発行されたことを示すフラグです。 このフラグは、最初の通知の発行時に監視対象の属性の型が正しい(使用するモニターによって異なる)ことを確認するために使用されます。- 関連項目:
- 定数フィールド値
 
 - 
RUNTIME_ERROR_NOTIFIEDprotected static final int RUNTIME_ERROR_NOTIFIED 監視対象のオブジェクトまたは属性の変更後、通知が発行されたことを示すフラグです。 このフラグは、最初の通知の発行時に監視対象の属性の値を取得しようとしたとき、例外があれば通知するために使用されます(上記の場合を除く)。- 関連項目:
- 定数フィールド値
 
 - 
dbgTag@Deprecated protected String dbgTag 非推奨。 代替はありません。このフィールドは互換性のために確保されているだけで、参照できません。
 
- 
 - 
メソッドの詳細- 
preRegisterpublic ObjectName preRegister(MBeanServer server, ObjectName name) throws Exception MBeanサーバーに登録する前に必要なオペレーションをモニターMBeanが実行することを許可します。MBeanサーバーの参照を初期化します。 - 定義:
- preRegister、インタフェース:- MBeanRegistration
- パラメータ:
- server- MBeanサーバー。モニターMBeanはこのMBeanサーバーに登録される。
- name- モニターMBeanのオブジェクト名。
- 戻り値:
- 登録済みモニターMBeanの名前。
- 例外:
- Exception- 何かがうまくいかない場合
 
 - 
postRegisterpublic void postRegister(Boolean registrationDone) MBeanサーバーへの登録が成功または失敗したあと、モニターMBeanが必要なオペレーションを実行できるようにします。このコンテキストでは使用しません。 - 定義:
- postRegister、インタフェース:- MBeanRegistration
- パラメータ:
- registrationDone- MBeanがMBeanサーバーに正常に登録されたかどうかを示す。 登録に失敗した場合の値はfalse。
 
 - 
preDeregisterpublic void preDeregister() throws ExceptionMBeanサーバーから登録解除する前に、モニターMBeanが必要なオペレーションを実行できるようにします。モニターを停止します。 - 定義:
- preDeregister、インタフェース:- MBeanRegistration
- 例外:
- Exception- 何かがうまくいかない場合
 
 - 
postDeregisterpublic void postDeregister() MBeanサーバーから登録解除したあと、モニターMBeanが必要なオペレーションを実行できるようにします。このコンテキストでは使用しません。 - 定義:
- postDeregister、インタフェース:- MBeanRegistration
 
 - 
startpublic abstract void start() モニターを開始します。- 定義:
- start、インタフェース:- MonitorMBean
 
 - 
stoppublic abstract void stop() モニターを停止します。- 定義:
- stop、インタフェース:- MonitorMBean
 
 - 
getObservedObject@Deprecated public ObjectName getObservedObject() 非推奨。 JMX 1.2以降は、getObservedObjects()に置き換えられています。監視対象のMBeanのセット内の最初のオブジェクトのオブジェクト名を返します。該当するオブジェクトが存在しない場合、nullを返します。- 定義:
- getObservedObject、インタフェース:- MonitorMBean
- 戻り値:
- 監視対象のオブジェクト。
- 関連項目:
- setObservedObject(ObjectName)
 
 - 
setObservedObject@Deprecated public void setObservedObject(ObjectName object) throws IllegalArgumentException 非推奨。 JMX 1.2以降は、addObservedObject(javax.management.ObjectName)に置き換えられています。監視対象のオブジェクトのセットからすべてのオブジェクトを削除し、指定されたオブジェクトを追加します。- 定義:
- setObservedObject、インタフェース:- MonitorMBean
- パラメータ:
- object- 監視対象のオブジェクト。
- 例外:
- IllegalArgumentException- 指定されたオブジェクトがnullの場合。
- 関連項目:
- getObservedObject()
 
 - 
addObservedObjectpublic void addObservedObject(ObjectName object) throws IllegalArgumentException 監視対象のMBeanのセットに指定されたオブジェクトが含まれない場合、そのオブジェクトを追加します。- 定義:
- addObservedObject、インタフェース:- MonitorMBean
- パラメータ:
- object- 監視対象のオブジェクト。
- 例外:
- IllegalArgumentException- 指定されたオブジェクトがnullの場合。
 
 - 
removeObservedObjectpublic void removeObservedObject(ObjectName object) 監視対象のMBeanのセットから指定されたオブジェクトを削除します。- 定義:
- removeObservedObject、インタフェース:- MonitorMBean
- パラメータ:
- object- 削除するオブジェクト。
 
 - 
containsObservedObjectpublic boolean containsObservedObject(ObjectName object) 監視対象のMBeanのセット内に指定されたオブジェクトが含まれるかどうかをテストします。- 定義:
- containsObservedObject、インタフェース:- MonitorMBean
- パラメータ:
- object- チェック対象のオブジェクト。
- 戻り値:
- 指定された要素が存在する場合はtrue、そうでない場合はfalse。
 
 - 
getObservedObjectspublic ObjectName[] getObservedObjects() 監視対象のオブジェクトを含む配列を返します。- 定義:
- getObservedObjects、インタフェース:- MonitorMBean
- 戻り値:
- 監視対象のオブジェクト。
 
 - 
getObservedAttributepublic String getObservedAttribute() 監視対象の属性を取得します。
 監視対象の属性は、デフォルトでは初期化されません(nullに設定される)。- 定義:
- getObservedAttribute、インタフェース:- MonitorMBean
- 戻り値:
- 監視対象の属性。
- 関連項目:
- setObservedAttribute(java.lang.String)
 
 - 
setObservedAttributepublic void setObservedAttribute(String attribute) throws IllegalArgumentException 監視対象の属性を設定します。
 監視対象の属性は、デフォルトでは初期化されません(nullに設定される)。- 定義:
- setObservedAttribute、インタフェース:- MonitorMBean
- パラメータ:
- attribute- 監視対象の属性。
- 例外:
- IllegalArgumentException- 指定された属性がnullの場合。
- 関連項目:
- getObservedAttribute()
 
 - 
getGranularityPeriodpublic long getGranularityPeriod() 粒度周期(ミリ秒単位)を取得します。
 デフォルトの粒度周期の値は10秒です。- 定義:
- getGranularityPeriod、インタフェース:- MonitorMBean
- 戻り値:
- 粒度周期の値。
- 関連項目:
- setGranularityPeriod(long)
 
 - 
setGranularityPeriodpublic void setGranularityPeriod(long period) throws IllegalArgumentException粒度周期をミリ秒単位で設定します。
 デフォルトの粒度周期の値は10秒です。- 定義:
- setGranularityPeriod、インタフェース:- MonitorMBean
- パラメータ:
- period- 粒度周期の値。
- 例外:
- IllegalArgumentException- 粒度周期がゼロ以下の場合。
- 関連項目:
- getGranularityPeriod()
 
 - 
isActivepublic boolean isActive() - 定義:
- isActive、インタフェース:- MonitorMBean
- 戻り値:
- モニターMBeanがアクティブな場合はtrue、そうでない場合はfalse。
 
 
- 
 
-