クラス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

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    protected int
    alreadyNotified
    非推奨。
    alreadyNotifieds [0]と同等です。
    protected int[]
    alreadyNotifieds
    すでに通知された選択済みモニター・エラーです。
    protected static final int
    capacityIncrement
    モニター配列のサイズが容量より大きくなったとき自動的に増加する容量です。
    protected String
    dbgTag
    非推奨。
    代替はありません。
    protected int
    elementCount
    監視対象のオブジェクトのベクトル内の有効なコンポーネントの数です。
    protected static final int
    OBSERVED_ATTRIBUTE_ERROR_NOTIFIED
    監視対象の属性の変更後、通知が発行されたことを示すフラグです。
    protected static final int
    OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED
    監視対象のオブジェクトまたは属性の変更後、通知が発行されたことを示すフラグです。
    protected static final int
    OBSERVED_OBJECT_ERROR_NOTIFIED
    監視対象のオブジェクトの変更後、通知が発行されたことを示すフラグです。
    protected static final int
    RESET_FLAGS_ALREADY_NOTIFIED
    このフラグは、モニター属性alreadyNotifiedsをリセットするために使用されます。
    protected static final int
    RUNTIME_ERROR_NOTIFIED
    監視対象のオブジェクトまたは属性の変更後、通知が発行されたことを示すフラグです。
    protected MBeanServer
    server
    MBeanサーバーへの参照です。

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

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    addObservedObject(ObjectName object)
    監視対象のMBeanのセットに指定されたオブジェクトが含まれない場合、そのオブジェクトを追加します。
    boolean
    containsObservedObject(ObjectName object)
    監視対象のMBeanのセット内に指定されたオブジェクトが含まれるかどうかをテストします。
    long
    getGranularityPeriod()
    粒度周期(ミリ秒単位)を取得します。
    String
    getObservedAttribute()
    監視対象の属性を取得します。
    ObjectName
    getObservedObject()
    非推奨。
    JMX 1.2で、getObservedObjects()に置き換えられました
    ObjectName[]
    getObservedObjects()
    監視対象のオブジェクトを含む配列を返します。
    boolean
    isActive()
    モニターMBeanがアクティブかどうかをテストします。
    void
    postDeregister()
    MBeanサーバーから登録解除したあと、モニターMBeanが必要なオペレーションを実行できるようにします。
    void
    postRegister(Boolean registrationDone)
    MBeanサーバーへの登録が成功または失敗したあと、モニターMBeanが必要なオペレーションを実行できるようにします。
    void
    preDeregister()
    MBeanサーバーから登録解除する前に、モニターMBeanが必要なオペレーションを実行できるようにします。
    ObjectName
    preRegister(MBeanServer server, ObjectName name)
    MBeanサーバーに登録する前に必要なオペレーションをモニターMBeanが実行することを許可します。
    void
    removeObservedObject(ObjectName object)
    監視対象のMBeanのセットから指定されたオブジェクトを削除します。
    void
    setGranularityPeriod(long period)
    粒度周期をミリ秒単位で設定します。
    void
    setObservedAttribute(String attribute)
    監視対象の属性を設定します。
    void
    setObservedObject(ObjectName object)
    非推奨。
    JMX 1.2以降、addObservedObject(ObjectName)に置き換えられました
    abstract void
    start()
    モニターを開始します。
    abstract void
    stop()
    モニターを停止します。

    クラスで宣言されたメソッド NotificationBroadcasterSupport

    addNotificationListener, getNotificationInfo, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification
    修飾子と型
    メソッド
    説明
    void
    addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
    リスナーを追加します。
    MBeanNotificationInfo[]
    getNotificationInfo()
    このMBeanが送信する可能性のある各通知について、その通知のJavaクラス名と通知タイプを示す配列を返します。
    protected void
    handleNotification(NotificationListener listener, Notification notif, Object handback)
    このメソッドは、リスナーに通知を送信するため、sendNotificationによって呼び出されます。
    void
    removeNotificationListener(NotificationListener listener)
    このMBeanからリスナーを削除します。
    void
    removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
    このMBeanからリスナーを削除します。
    void
    sendNotification(Notification notification)
    通知を送信します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • 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(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。