Module java.management

Package javax.management.monitor

Class 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，用于观察规模属性的值。

规模监视器观察一个随时间连续变化的属性。规模监视器发送通知如下:

• 如果属性值正在增加并且变得等于或大于高阈值，则发送一个高阈值通知。必须将通知高标志设置为true。
  高阈值值后续的交叉不会导致进一步的通知，除非属性值变得等于或小于低阈值。
• 如果属性值正在减少并且变得等于或小于低阈值，则发送一个低阈值通知。必须将通知低标志设置为true。
  低阈值值后续的交叉不会导致进一步的通知，除非属性值变得等于或大于高阈值。

这提供了一个滞后机制，以避免当属性值围绕高或低阈值做小幅振荡时重复触发通知。

如果使用规模差异模式，则派生规模的值被计算为两次观察的观察规模值之间的差异。
使用以下方法计算派生规模值（V[t]）:

• V[t] = 规模[t] - 规模[t-GP]

规模监视器的此实现要求观察的属性为整数或浮点数类型（Byte, Integer, Short, Long, Float, Double）。

自1.5版本起:

1.5

Field Summary

Fields declared in class 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

Constructor Summary

Constructors

Constructor	Description
GaugeMonitor()	默认构造函数。

Method Summary

Modifier and Type	Method	Description
Number	getDerivedGauge()	已弃用。 自JMX 1.2起，已被getDerivedGauge(ObjectName)替代
Number	getDerivedGauge(ObjectName object)	获取指定对象的派生规模，如果此对象包含在观察的MBean集合中，则返回null。
long	getDerivedGaugeTimeStamp()	已弃用。 自JMX 1.2起，已被getDerivedGaugeTimeStamp(ObjectName)替代
long	getDerivedGaugeTimeStamp(ObjectName object)	获取指定对象的派生规模时间戳，如果此对象包含在观察的MBean集合中，则返回0。
boolean	getDifferenceMode()	获取所有观察的MBean的差异模式标志值。
Number	getHighThreshold()	获取所有观察的MBean的高阈值。
Number	getLowThreshold()	获取所有观察的MBean的低阈值。
MBeanNotificationInfo[]	getNotificationInfo()	返回一个包含通知的Java类名称和规模监视器发送的通知类型的NotificationInfo对象。
boolean	getNotifyHigh()	获取所有观察的MBean的高通知开关值。
boolean	getNotifyLow()	获取所有观察的MBean的低通知开关值。
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()	停止规模监视器。

Methods declared in class javax.management.monitor.Monitor

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

Methods declared in class javax.management.NotificationBroadcasterSupport

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Methods declared in class java.lang.Object

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

Methods declared in interface javax.management.monitor.MonitorMBean

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

Constructor Details

GaugeMonitor

             public GaugeMonitor()
            

默认构造函数。

Method Details

start

             public void start()
            

启动规模监视器。

指定者:

start 在接口 MonitorMBean中

指定者:

start 在类 Monitor中

stop

             public void stop()
            

停止规模监视器。

指定者:

stop 在接口 MonitorMBean中

指定者:

stop 在类 Monitor中

getDerivedGauge

             public Number getDerivedGauge(ObjectName object)
            

获取指定对象的派生规模，如果此对象包含在观察的MBean集合中，则返回null。

指定者:

getDerivedGauge 在接口 GaugeMonitorMBean中

参数:

object - MBean的名称。

返回:

指定对象的派生规模。

getDerivedGaugeTimeStamp

             public long getDerivedGaugeTimeStamp(ObjectName object)
            

获取指定对象的派生规模时间戳，如果此对象包含在观察的MBean集合中，则返回0。

指定者:

getDerivedGaugeTimeStamp 在接口 GaugeMonitorMBean中

参数:

object - 要返回其派生规模时间戳的对象的名称。

返回:

指定对象的派生规模时间戳。

getDerivedGauge

             @Deprecated public Number getDerivedGauge()
            

Deprecated.

As of JMX 1.2, replaced by getDerivedGauge(ObjectName)

返回观察的MBean集合中第一个对象的派生规模。

指定者:

getDerivedGauge 在接口 GaugeMonitorMBean中

返回:

派生规模。

getDerivedGaugeTimeStamp

             @Deprecated public long getDerivedGaugeTimeStamp()
            

Deprecated.

As of JMX 1.2, replaced by getDerivedGaugeTimeStamp(ObjectName)

获取观察的MBean集合中第一个对象的派生规模时间戳。

指定者:

getDerivedGaugeTimeStamp 在接口 GaugeMonitorMBean中

返回:

派生规模时间戳。

getHighThreshold

             public Number getHighThreshold()
            

获取所有观察的MBean的高阈值。

指定者:

getHighThreshold 在接口 GaugeMonitorMBean中

返回:

高阈值。

参见:

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

getLowThreshold

             public Number getLowThreshold()
            

获取所有观察的MBean的低阈值。

指定者:

getLowThreshold 在接口 GaugeMonitorMBean中

返回:

低阈值。

参见:

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

setThresholds

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

设置所有观察的MBean的高和低阈值。

指定者:

setThresholds 在接口 GaugeMonitorMBean中

参数:

highValue - 高阈值。

lowValue - 低阈值。

抛出:

IllegalArgumentException - 指定的高/低阈值为null或低阈值大于高阈值或高阈值和低阈值不是相同类型。

参见:

• getHighThreshold()
• getLowThreshold()

getNotifyHigh

             public boolean getNotifyHigh()
            

获取所有观察的MBean的高通知开关值。

指定者:

getNotifyHigh 在接口 GaugeMonitorMBean中

返回:

如果规模监视器在超过高阈值时通知，则返回true，否则返回false。

参见:

• setNotifyHigh(boolean)

setNotifyHigh

             public void setNotifyHigh(boolean value)
            

设置所有观察的MBean的高通知开关值。

指定者:

setNotifyHigh 在接口 GaugeMonitorMBean中

参数:

value - 高通知的开关值。

参见:

• getNotifyHigh()

getNotifyLow

             public boolean getNotifyLow()
            

获取所有被观察的MBean共同的低通知开关值。

指定者:

getNotifyLow 在接口 GaugeMonitorMBean中

返回:

如果规范监视器在低阈值超过时通知，则返回true，否则返回false。

参见:

• setNotifyLow(boolean)

setNotifyLow

             public void setNotifyLow(boolean value)
            

设置所有被观察的MBean共同的低通知开关值。

指定者:

setNotifyLow 在接口 GaugeMonitorMBean中

参数:

value - 低通知的开关值。

参见:

• getNotifyLow()

getDifferenceMode

             public boolean getDifferenceMode()
            

获取所有被观察的MBean共同的差值模式标志值。

指定者:

getDifferenceMode 在接口 GaugeMonitorMBean中

返回:

如果使用差值模式，则返回true，否则返回false。

参见:

• setDifferenceMode(boolean)

setDifferenceMode

             public void setDifferenceMode(boolean value)
            

设置所有被观察的MBean共同的差值模式标志值。

指定者:

setDifferenceMode 在接口 GaugeMonitorMBean中

参数:

value - 差值模式标志值。

参见:

• getDifferenceMode()

getNotificationInfo

             public MBeanNotificationInfo[] getNotificationInfo()
            

返回一个包含通知的Java类的名称和规范监视器发送的通知类型的NotificationInfo对象。

指定者:

getNotificationInfo 在接口 NotificationBroadcaster中

返回:

可能通知的数组。