javax.management.monitor
類別 CounterMonitor

java.lang.Object
  javax.management.NotificationBroadcasterSupport
      javax.management.monitor.Monitor
          javax.management.monitor.CounterMonitor

所有已實作的介面：

MBeanRegistration, CounterMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter

public class CounterMonitor
extends Monitor
implements CounterMonitorMBean

定義專門用來觀察計數器屬性值的監視器 MBean。

當計數器的值達到或超過已知比較級別閾值時，計數器監視器將發送一個閾值通知。必須將通知標誌設置為 true。

另外，偏移量機制支持對特定計數區間的檢測。如果偏移量值不為零，則每當計數器值達到比較級別而觸發該閾值時，比較級別都將遞增該偏移量值。這是在瞬間完成的，即在增加計數前完成。因此，對於每個級別，每當計數增加的區間等於偏移值時，閾值都將觸發一個事件通知。

如果計數器能夠包含其最大值，則必須指定模。模是將計數器重置為零時的值。

如果使用了計數器差分網要，則派生的尺度值將被視為兩次連續觀察到的計數器值之間的差分。如果此差分為負值，則派生的尺度值將增加該模的值。派生的尺度值 (V[t]) 是使用以下方法計算的：

• if (counter[t] - counter[t-GP]) is positive then V[t] = counter[t] - counter[t-GP]
• if (counter[t] - counter[t-GP]) is negative then V[t] = counter[t] - counter[t-GP] + MODULUS

計數器監視器的這一實作要求 observed 屬性的型別為整數（Byte、Integer、Short 和 Long）。

從以下版本開始：

1.5

欄位摘要

從類別 javax.management.monitor.Monitor 繼承的欄位

alreadyNotified, alreadyNotifieds, capacityIncrement, dbgTag, elementCount, OBSERVED_ATTRIBUTE_ERROR_NOTIFIED, OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED, OBSERVED_OBJECT_ERROR_NOTIFIED, RESET_FLAGS_ALREADY_NOTIFIED, RUNTIME_ERROR_NOTIFIED, server

建構子摘要

CounterMonitor()
預設的建構子。

方法摘要

Number	getDerivedGauge() 已過時。 從 JMX 1.2 開始，由 getDerivedGauge(ObjectName) 取代
Number	getDerivedGauge(ObjectName object) 如果指定的物件包含在所觀察的 MBeans 集中，則獲取此物件派生的尺度，否則將為 null。
long	getDerivedGaugeTimeStamp() 已過時。 從 JMX 1.2 開始，由 getDerivedGaugeTimeStamp(ObjectName) 取代
long	getDerivedGaugeTimeStamp(ObjectName object) 如果指定的物件包含在所觀察的 MBeans 集中，則獲取此物件的派生尺度的時間戳，否則將為 0。
boolean	getDifferenceMode() 獲取所有觀察到的 MBeans 的共同的差分網要標誌值。
Number	getInitThreshold() 獲取所有觀察物件的公共初始閾值。
Number	getModulus() 獲取所有觀察到的 MBeans 共同的模值。
MBeanNotificationInfo[]	getNotificationInfo() 返回一個 NotificationInfo 物件，它包含通知的 Java 類別的名稱和由計數器監視器發送的通知型別。
boolean	getNotify() 獲取所有觀察到的 MBeans 共同的通知的開/關切換值。
Number	getOffset() 獲取所有觀察到的 MBeans 共同的偏移量值。
Number	getThreshold() 已過時。 從 JMX 1.2 開始，由 getThreshold(ObjectName) 取代
Number	getThreshold(ObjectName object) 如果指定的物件包含在觀察到的 MBeans 集中，則獲取指定物件的當前閾值，否則將為 null。
void	setDifferenceMode(boolean value) 設置所有觀察到的 MBeans 的共同的差分網要標誌值。
void	setInitThreshold(Number value) 設置所有觀察物件的共同初始閾值。
void	setModulus(Number value) 設置所有觀察到的 MBeans 共同的模值。
void	setNotify(boolean value) 設置所有觀察到的 MBeans 共同的通知的開/關切換值。
void	setOffset(Number value) 設置所有觀察到的 MBeans 共同的偏移量值。
void	setThreshold(Number value) 已過時。 從 JMX 1.2 開始，由 setInitThreshold(java.lang.Number) 取代
void	start() 啟動計數器監視器。
void	stop() 停止計數器監視器。

從類別 javax.management.monitor.Monitor 繼承的方法

addObservedObject, containsObservedObject, getGranularityPeriod, getObservedAttribute, getObservedObject, getObservedObjects, isActive, postDeregister, postRegister, preDeregister, preRegister, removeObservedObject, setGranularityPeriod, setObservedAttribute, setObservedObject

從類別 javax.management.NotificationBroadcasterSupport 繼承的方法

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

從介面 javax.management.monitor.MonitorMBean 繼承的方法

addObservedObject, containsObservedObject, getGranularityPeriod, getObservedAttribute, getObservedObject, getObservedObjects, isActive, removeObservedObject, setGranularityPeriod, setObservedAttribute, setObservedObject

建構子詳細資訊

CounterMonitor

public CounterMonitor()

預設的建構子。

方法詳細資訊

start

public void start()

啟動計數器監視器。

指定者：

介面 MonitorMBean 中的 start

指定者：

類別 Monitor 中的 start

stop

public void stop()

停止計數器監視器。

指定者：

介面 MonitorMBean 中的 stop

指定者：

類別 Monitor 中的 stop

getDerivedGauge

public Number getDerivedGauge(ObjectName object)

如果指定的物件包含在所觀察的 MBeans 集中，則獲取此物件派生的尺度，否則將為 null。

指定者：

介面 CounterMonitorMBean 中的 getDerivedGauge

參數：

object - 將返回其派生尺度的物件的名稱。

返回：

指定物件的派生尺度。

getDerivedGaugeTimeStamp

public long getDerivedGaugeTimeStamp(ObjectName object)

如果指定的物件包含在所觀察的 MBeans 集中，則獲取此物件的派生尺度的時間戳，否則將為 0。

指定者：

介面 CounterMonitorMBean 中的 getDerivedGaugeTimeStamp

參數：

object - 將返回其派生尺度時間戳的物件的名稱。

返回：

指定物件的派生尺度時間戳。

getThreshold

public Number getThreshold(ObjectName object)

如果指定的物件包含在觀察到的 MBeans 集中，則獲取指定物件的當前閾值，否則將為 null。

指定者：

介面 CounterMonitorMBean 中的 getThreshold

參數：

object - 將返回其閾值的物件的名稱。

返回：

指定物件的閾值。

另請參見：

CounterMonitorMBean.setThreshold(java.lang.Number)

getInitThreshold

public Number getInitThreshold()

獲取所有觀察物件的公共初始閾值。

指定者：

介面 CounterMonitorMBean 中的 getInitThreshold

返回：

初始閾值。

另請參見：

setInitThreshold(java.lang.Number)

setInitThreshold

public void setInitThreshold(Number value)
                      throws IllegalArgumentException

設置所有觀察物件的共同初始閾值。
所觀察 MBeans 集中每個物件的當前閾值都將因此得到更新。

指定者：

介面 CounterMonitorMBean 中的 setInitThreshold

參數：

value - 初始閾值。

拋出：

IllegalArgumentException - 指定的閾值為 null，或者閾值小於零。

另請參見：

getInitThreshold()

getDerivedGauge

@Deprecated
public Number getDerivedGauge()

已過時。 從 JMX 1.2 開始，由 getDerivedGauge(ObjectName) 取代

返回所觀察 MBeans 集中第一個物件的派生尺度。

指定者：

介面 CounterMonitorMBean 中的 getDerivedGauge

返回：

派生的尺度。

getDerivedGaugeTimeStamp

@Deprecated
public long getDerivedGaugeTimeStamp()

已過時。 從 JMX 1.2 開始，由 getDerivedGaugeTimeStamp(ObjectName) 取代

獲取所觀察 MBeans 集中第一個物件的派生尺度時間戳。

指定者：

介面 CounterMonitorMBean 中的 getDerivedGaugeTimeStamp

返回：

派生的尺度時間戳。

getThreshold

@Deprecated
public Number getThreshold()

已過時。 從 JMX 1.2 開始，由 getThreshold(ObjectName) 取代

返回所觀察 MBeans 集中第一個物件的閾值。

指定者：

介面 CounterMonitorMBean 中的 getThreshold

返回：

閾值。

另請參見：

setThreshold(java.lang.Number)

setThreshold

@Deprecated
public void setThreshold(Number value)
                  throws IllegalArgumentException

已過時。 從 JMX 1.2 開始，由 setInitThreshold(java.lang.Number) 取代

設置初始閾值。

指定者：

介面 CounterMonitorMBean 中的 setThreshold

參數：

value - 初始閾值。

拋出：

IllegalArgumentException - 指定的閾值為 null，或者該閾值小於零。

另請參見：

getThreshold()

getOffset

public Number getOffset()

獲取所有觀察到的 MBeans 共同的偏移量值。

指定者：

介面 CounterMonitorMBean 中的 getOffset

返回：

偏移量值。

另請參見：

setOffset(java.lang.Number)

setOffset

public void setOffset(Number value)
               throws IllegalArgumentException

設置所有觀察到的 MBeans 共同的偏移量值。

指定者：

介面 CounterMonitorMBean 中的 setOffset

參數：

value - 偏移量值。

拋出：

IllegalArgumentException - 指定的偏移量值為 null，或者該偏移量值小於零。

另請參見：

getOffset()

getModulus

public Number getModulus()

獲取所有觀察到的 MBeans 共同的模值。

指定者：

介面 CounterMonitorMBean 中的 getModulus

返回：

模值。

另請參見：

setModulus(java.lang.Number)

setModulus

public void setModulus(Number value)
                throws IllegalArgumentException

設置所有觀察到的 MBeans 共同的模值。

指定者：

介面 CounterMonitorMBean 中的 setModulus

參數：

value - 模值。

拋出：

IllegalArgumentException - 指定的模為 null，或者該模小於零。

另請參見：

getModulus()

getNotify

public boolean getNotify()

獲取所有觀察到的 MBeans 共同的通知的開/關切換值。

指定者：

介面 CounterMonitorMBean 中的 getNotify

返回：

如果超出閾值時計數器監視器發出通知，則返回 true，否則返回 false。

另請參見：

setNotify(boolean)

setNotify

public void setNotify(boolean value)

設置所有觀察到的 MBeans 共同的通知的開/關切換值。

指定者：

介面 CounterMonitorMBean 中的 setNotify

參數：

value - 通知的開/關切換值。

另請參見：

getNotify()

getDifferenceMode

public boolean getDifferenceMode()

獲取所有觀察到的 MBeans 的共同的差分網要標誌值。

指定者：

介面 CounterMonitorMBean 中的 getDifferenceMode

返回：

如果使用了差分網要，則返回 true；否則返回 false。

另請參見：

setDifferenceMode(boolean)

setDifferenceMode

public void setDifferenceMode(boolean value)

設置所有觀察到的 MBeans 的共同的差分網要標誌值。

指定者：

介面 CounterMonitorMBean 中的 setDifferenceMode

參數：

value - 差分網要標誌值。

另請參見：

getDifferenceMode()

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

返回一個 NotificationInfo 物件，它包含通知的 Java 類別的名稱和由計數器監視器發送的通知型別。

指定者：

介面 NotificationBroadcaster 中的 getNotificationInfo

覆寫：

類別 NotificationBroadcasterSupport 中的 getNotificationInfo

返回：

可能的通知陣列。