モジュール java.management
パッケージ javax.management.monitor

クラスMonitor

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

  • フィールド詳細

    • capacityIncrement

      protected static final int capacityIncrement
      モニター配列のサイズが容量より大きくなったとき自動的に増加する容量です。
      関連項目:

    • elementCount

      protected int elementCount
      監視対象のオブジェクトのベクトル内の有効なコンポーネントの数です。

    • alreadyNotified

      @Deprecated protected int alreadyNotified
      非推奨。
      alreadyNotifieds[0]と同等です。
      すでに通知されたモニター・エラーです。

    • alreadyNotifieds

      protected int[] alreadyNotifieds

      すでに通知された選択済みモニター・エラーです。

      この配列内の各要素は、ベクトル内の監視対象オブジェクトに対応しています。 OBSERVED_OBJECT_ERROR_NOTIFIEDフラグなどのビット・マスクを含み、対応する通知がすでに監視対象のMBeanに送信されたかどうかを示します。

    • server

      protected MBeanServer server
      MBeanサーバーへの参照です。 この参照は、モニターMBeanがMBeanサーバーに登録されていない場合nullになります。 モニターMBeanがMBeanに登録される前に初期化されます。
      関連項目:

    • RESET_FLAGS_ALREADY_NOTIFIED

      protected static final int RESET_FLAGS_ALREADY_NOTIFIED
      このフラグは、モニター属性alreadyNotifiedsをリセットするために使用されます。
      関連項目:

    • OBSERVED_OBJECT_ERROR_NOTIFIED

      protected static final int OBSERVED_OBJECT_ERROR_NOTIFIED
      監視対象のオブジェクトの変更後、通知が発行されたことを示すフラグです。 このフラグは、最初の通知の発行時にMBeanサーバーに新しい監視対象オブジェクトが登録されたことを確認するために使用されます。
      関連項目:

    • OBSERVED_ATTRIBUTE_ERROR_NOTIFIED

      protected static final int OBSERVED_ATTRIBUTE_ERROR_NOTIFIED
      監視対象の属性の変更後、通知が発行されたことを示すフラグです。 このフラグは、最初の通知の発行時に新しい監視対象の属性が監視対象のオブジェクトに所属することを確認するために使用されます。
      関連項目:

    • OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED

      protected static final int OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED
      監視対象のオブジェクトまたは属性の変更後、通知が発行されたことを示すフラグです。 このフラグは、最初の通知の発行時に監視対象の属性の型が正しい(使用するモニターによって異なる)ことを確認するために使用されます。
      関連項目:

    • RUNTIME_ERROR_NOTIFIED

      protected static final int RUNTIME_ERROR_NOTIFIED
      監視対象のオブジェクトまたは属性の変更後、通知が発行されたことを示すフラグです。 このフラグは、最初の通知の発行時に監視対象の属性の値を取得しようとしたとき、例外があれば通知するために使用されます(上記の場合を除く)。
      関連項目:

    • dbgTag

      @Deprecated protected String dbgTag
      非推奨。
      代替はありません。
      このフィールドは互換性のために確保されているだけで、参照できません。

  • コンストラクタの詳細

    • Monitor

      public Monitor()
      サブクラスが呼び出すためのコンストラクタ。

  • メソッドの詳細

    • preRegister

      public ObjectName preRegister(MBeanServer server, ObjectName name) throws Exception
      MBeanサーバーに登録する前に必要なオペレーションをモニターMBeanが実行することを許可します。

      MBeanサーバーの参照を初期化します。

      定義:
      preRegister、インタフェースMBeanRegistration
      パラメータ:
      server - MBeanサーバー。モニターMBeanはこのMBeanサーバーに登録される。
      name - モニターMBeanのオブジェクト名。
      戻り値:
      登録済みモニターMBeanの名前。
      例外:
      Exception - 何かがうまくいかない場合

    • postRegister

      public void postRegister(Boolean registrationDone)
      MBeanサーバーへの登録が成功または失敗したあと、モニターMBeanが必要なオペレーションを実行できるようにします。

      このコンテキストでは使用しません。

      定義:
      postRegister、インタフェースMBeanRegistration
      パラメータ:
      registrationDone - MBeanがMBeanサーバーに正常に登録されたかどうかを示す。 登録に失敗した場合の値はfalse。

    • preDeregister

      public void preDeregister() throws Exception
      MBeanサーバーから登録解除する前に、モニターMBeanが必要なオペレーションを実行できるようにします。

      モニターを停止します。

      定義:
      preDeregister、インタフェースMBeanRegistration
      例外:
      Exception - 何かがうまくいかない場合

    • postDeregister

      public void postDeregister()
      MBeanサーバーから登録解除したあと、モニターMBeanが必要なオペレーションを実行できるようにします。

      このコンテキストでは使用しません。

      定義:
      postDeregister、インタフェースMBeanRegistration

    • start

      public abstract void start()
      モニターを開始します。
      定義:
      start、インタフェースMonitorMBean

    • stop

      public abstract void stop()
      モニターを停止します。
      定義:
      stop、インタフェースMonitorMBean

    • getObservedObject

      @Deprecated public ObjectName getObservedObject()
      非推奨。
      JMX 1.2以降は、getObservedObjects()に置き換えられています。
      監視対象のMBeanのセット内の最初のオブジェクトのオブジェクト名を返します。該当するオブジェクトが存在しない場合、nullを返します。
      定義:
      getObservedObject、インタフェースMonitorMBean
      戻り値:
      監視対象のオブジェクト。
      関連項目:

    • setObservedObject

      @Deprecated public void setObservedObject(ObjectName object) throws IllegalArgumentException
      非推奨。
      JMX 1.2以降は、addObservedObject(javax.management.ObjectName)に置き換えられています。
      監視対象のオブジェクトのセットからすべてのオブジェクトを削除し、指定されたオブジェクトを追加します。
      定義:
      setObservedObject、インタフェースMonitorMBean
      パラメータ:
      object - 監視対象のオブジェクト。
      例外:
      IllegalArgumentException - 指定されたオブジェクトがnullの場合。
      関連項目:

    • addObservedObject

      public void addObservedObject(ObjectName object) throws IllegalArgumentException
      監視対象のMBeanのセットに指定されたオブジェクトが含まれない場合、そのオブジェクトを追加します。
      定義:
      addObservedObject、インタフェースMonitorMBean
      パラメータ:
      object - 監視対象のオブジェクト。
      例外:
      IllegalArgumentException - 指定されたオブジェクトがnullの場合。

    • removeObservedObject

      public void removeObservedObject(ObjectName object)
      監視対象のMBeanのセットから指定されたオブジェクトを削除します。
      定義:
      removeObservedObject、インタフェースMonitorMBean
      パラメータ:
      object - 削除するオブジェクト。

    • containsObservedObject

      public boolean containsObservedObject(ObjectName object)
      監視対象のMBeanのセット内に指定されたオブジェクトが含まれるかどうかをテストします。
      定義:
      containsObservedObject、インタフェースMonitorMBean
      パラメータ:
      object - チェック対象のオブジェクト。
      戻り値:
      指定された要素が存在する場合はtrue、そうでない場合はfalse。

    • getObservedObjects

      public ObjectName[] getObservedObjects()
      監視対象のオブジェクトを含む配列を返します。
      定義:
      getObservedObjects、インタフェースMonitorMBean
      戻り値:
      監視対象のオブジェクト。

    • getObservedAttribute

      public String getObservedAttribute()
      監視対象の属性を取得します。
      監視対象の属性は、デフォルトでは初期化されません(nullに設定される)。
      定義:
      getObservedAttribute、インタフェースMonitorMBean
      戻り値:
      監視対象の属性。
      関連項目:

    • setObservedAttribute

      public void setObservedAttribute(String attribute) throws IllegalArgumentException
      監視対象の属性を設定します。
      監視対象の属性は、デフォルトでは初期化されません(nullに設定される)。
      定義:
      setObservedAttribute、インタフェースMonitorMBean
      パラメータ:
      attribute - 監視対象の属性。
      例外:
      IllegalArgumentException - 指定された属性がnullの場合。
      関連項目:

    • getGranularityPeriod

      public long getGranularityPeriod()
      粒度周期(ミリ秒単位)を取得します。
      デフォルトの粒度周期の値は10秒です。
      定義:
      getGranularityPeriod、インタフェースMonitorMBean
      戻り値:
      粒度周期の値。
      関連項目:

    • setGranularityPeriod

      public void setGranularityPeriod(long period) throws IllegalArgumentException
      粒度周期をミリ秒単位で設定します。
      デフォルトの粒度周期の値は10秒です。
      定義:
      setGranularityPeriod、インタフェースMonitorMBean
      パラメータ:
      period - 粒度周期の値。
      例外:
      IllegalArgumentException - 粒度周期がゼロ以下の場合。
      関連項目:

    • isActive

      public boolean isActive()
      モニターMBeanがアクティブかどうかをテストします。 モニターMBeanは、startメソッドが呼び出されるとアクティブになります。 stopメソッドが呼び出されると非アクティブになります。
      定義:
      isActive、インタフェースMonitorMBean
      戻り値:
      モニターMBeanがアクティブな場合はtrue、そうでない場合はfalse。