javax.management.monitor
類別 GaugeMonitor

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

所有已實作的介面：

MBeanRegistration, GaugeMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter

public class GaugeMonitor
extends Monitor
implements GaugeMonitorMBean

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

尺度監視器觀察隨著時間發展而不斷變化的屬性。尺度監視器將根據以下情況發送通知：

• 如果屬性值增加，變得與高閾值相等或大於高閾值，則發送一個閾值過高通知。必須將 notify high 標誌設置為 true。
  除非屬性值變得與低閾值相等或小於低閾值，否則高閾值的後續超出不會引發更多通知。
• 如果屬性值減小，變得與低閾值相等或小於低閾值，則將發送一個閾值過低通知。必須將 notify low 標誌設置為 true。
  除非屬性值變得等於或大於高閾值，否則後續低於閾值的超出不會引發更多通知。

這提供了一種滯後機制，可以避免屬性值圍繞高、低閾值小幅度擺動時重複觸發通知。

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

• V[t] = gauge[t] - gauge[t-GP]

尺度監視器的這一實作需要 observed 屬性的型別為整數或浮點型（Byte、Integer、Short、Long、Float 和 Double）。

從以下版本開始：

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

建構子摘要

GaugeMonitor()
預設的建構子。

方法摘要

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() 獲取所有觀察到的 MBean 的公共差分網要標誌值。
Number	getHighThreshold() 獲取所有所觀察的 MBean 的公共高閾值。
Number	getLowThreshold() 獲取所有觀察到的 MBean 的公共低閾值。
MBeanNotificationInfo[]	getNotificationInfo() 返回一個 NotificationInfo 物件，它包含通知的 Java 類別的名稱和由尺度監視器發送的通知型別。
boolean	getNotifyHigh() 獲取所有觀察到的 MBean 的公共高閾值通知 (high notification) 的開/關切換值。
boolean	getNotifyLow() 獲取所有觀察到的 MBean 的公共低閾值通知 (low notification) 的開/關切換值。
void	setDifferenceMode(boolean value) 設置所有觀察到的 MBean 的公共差分網要標誌值。
void	setNotifyHigh(boolean value) 設置所有觀察到的 MBean 的公共高閾值通知的開/關切換值。
void	setNotifyLow(boolean value) 設置所有觀察到的 MBean 的公共低閾值通知的開/關切換值。
void	setThresholds(Number highValue, Number lowValue) 設置所有觀察到的 MBean 的公共高、低閾值。
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

建構子詳細資訊

GaugeMonitor

public GaugeMonitor()

預設的建構子。

方法詳細資訊

start

public void start()

啟用尺度監視器。

指定者：

介面 MonitorMBean 中的 start

指定者：

類別 Monitor 中的 start

stop

public void stop()

停止尺度監視器。

指定者：

介面 MonitorMBean 中的 stop

指定者：

類別 Monitor 中的 stop

getDerivedGauge

public Number getDerivedGauge(ObjectName object)

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

指定者：

介面 GaugeMonitorMBean 中的 getDerivedGauge

參數：

object - MBean 的名稱。

返回：

指定物件的派生尺度。

getDerivedGaugeTimeStamp

public long getDerivedGaugeTimeStamp(ObjectName object)

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

指定者：

介面 GaugeMonitorMBean 中的 getDerivedGaugeTimeStamp

參數：

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

返回：

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

getDerivedGauge

@Deprecated
public Number getDerivedGauge()

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

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

指定者：

介面 GaugeMonitorMBean 中的 getDerivedGauge

返回：

派生的尺度。

getDerivedGaugeTimeStamp

@Deprecated
public long getDerivedGaugeTimeStamp()

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

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

指定者：

介面 GaugeMonitorMBean 中的 getDerivedGaugeTimeStamp

返回：

派生的尺度時間戳。

getHighThreshold

public Number getHighThreshold()

獲取所有所觀察的 MBean 的公共高閾值。

指定者：

介面 GaugeMonitorMBean 中的 getHighThreshold

返回：

高閾值。

另請參見：

setThresholds(java.lang.Number, java.lang.Number)

getLowThreshold

public Number getLowThreshold()

獲取所有觀察到的 MBean 的公共低閾值。

指定者：

介面 GaugeMonitorMBean 中的 getLowThreshold

返回：

低閾值。

另請參見：

setThresholds(java.lang.Number, java.lang.Number)

setThresholds

public void setThresholds(Number highValue,
                          Number lowValue)
                   throws IllegalArgumentException

設置所有觀察到的 MBean 的公共高、低閾值。

指定者：

介面 GaugeMonitorMBean 中的 setThresholds

參數：

highValue - 高閾值。

lowValue - 低閾值。

拋出：

IllegalArgumentException - 指定的高/低閾值為 null，或者低閾值大於高閾值，或者高、低閾值不屬於同一型別。

另請參見：

getHighThreshold(), getLowThreshold()

getNotifyHigh

public boolean getNotifyHigh()

獲取所有觀察到的 MBean 的公共高閾值通知 (high notification) 的開/關切換值。

指定者：

介面 GaugeMonitorMBean 中的 getNotifyHigh

返回：

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

另請參見：

setNotifyHigh(boolean)

setNotifyHigh

public void setNotifyHigh(boolean value)

設置所有觀察到的 MBean 的公共高閾值通知的開/關切換值。

指定者：

介面 GaugeMonitorMBean 中的 setNotifyHigh

參數：

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

另請參見：

getNotifyHigh()

getNotifyLow

public boolean getNotifyLow()

獲取所有觀察到的 MBean 的公共低閾值通知 (low notification) 的開/關切換值。

指定者：

介面 GaugeMonitorMBean 中的 getNotifyLow

返回：

如果超過低閾值時尺度監視器發出通知，則返回 true，否則返回 false。

另請參見：

setNotifyLow(boolean)

setNotifyLow

public void setNotifyLow(boolean value)

設置所有觀察到的 MBean 的公共低閾值通知的開/關切換值。

指定者：

介面 GaugeMonitorMBean 中的 setNotifyLow

參數：

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

另請參見：

getNotifyLow()

getDifferenceMode

public boolean getDifferenceMode()

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

指定者：

介面 GaugeMonitorMBean 中的 getDifferenceMode

返回：

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

另請參見：

setDifferenceMode(boolean)

setDifferenceMode

public void setDifferenceMode(boolean value)

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

指定者：

介面 GaugeMonitorMBean 中的 setDifferenceMode

參數：

value - 差分網要標誌值。

另請參見：

getDifferenceMode()

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

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

指定者：

介面 NotificationBroadcaster 中的 getNotificationInfo

覆寫：

類別 NotificationBroadcasterSupport 中的 getNotificationInfo

返回：

可能的通知陣列。