Module java.management

Package javax.management.monitor

Class 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]）使用以下方法计算：

• 如果（counter[t] - counter[t-GP]）为正，则V[t] = counter[t] - counter[t-GP]
• 如果（counter[t] - counter[t-GP]）为负，则V[t] = counter[t] - counter[t-GP] + MODULUS

此计数器监视器的实现要求观察属性为整数类型（Byte、Integer、Short、Long）。

自JDK版本:

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
CounterMonitor()	默认构造函数。

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	getInitThreshold()	获取所有观察对象的初始阈值。
Number	getModulus()	获取所有观察的MBean的模数值。
MBeanNotificationInfo[]	getNotificationInfo()	返回一个包含通知的Java类名称和计数器监视器发送的通知类型的NotificationInfo对象。
boolean	getNotify()	获取所有观察的MBean的通知开关值。
Number	getOffset()	获取所有观察的MBean的偏移值。
Number	getThreshold()	已弃用。 自JMX 1.2起，已被getThreshold(ObjectName)取代
Number	getThreshold(ObjectName object)	获取指定对象的当前阈值值，如果此对象包含在观察的MBean集合中，则返回null。
void	setDifferenceMode(boolean value)	设置所有观察的MBean的差值模式标志值。
void	setInitThreshold(Number value)	设置所有观察对象的初始阈值。
void	setModulus(Number value)	设置所有观察的MBean的模数值。
void	setNotify(boolean value)	设置所有观察的MBean的通知开关值。
void	setOffset(Number value)	设置所有观察的MBean的偏移值。
void	setThreshold(Number value)	已弃用。 自JMX 1.2起，已被setInitThreshold(java.lang.Number)取代
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

CounterMonitor

             public CounterMonitor()
            

默认构造函数。

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 在接口 CounterMonitorMBean中

参数:

object - 要返回其派生计量的对象的名称。

返回:

指定对象的派生计量。

getDerivedGaugeTimeStamp

             public long getDerivedGaugeTimeStamp(ObjectName object)
            

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

指定者:

getDerivedGaugeTimeStamp 在接口 CounterMonitorMBean中

参数:

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

返回:

指定对象的派生计量时间戳。

getThreshold

             public Number getThreshold(ObjectName object)
            

获取指定对象的当前阈值值，如果此对象包含在观察的MBean集合中，则返回null。

指定者:

getThreshold 在接口 CounterMonitorMBean中

参数:

object - 要返回其阈值的对象的名称。

返回:

指定对象的阈值值。

参见:

• CounterMonitorMBean.setThreshold(java.lang.Number)

getInitThreshold

             public Number getInitThreshold()
            

获取所有观察对象的初始阈值。

指定者:

getInitThreshold 在接口 CounterMonitorMBean中

返回:

初始阈值。

参见:

• setInitThreshold(java.lang.Number)

setInitThreshold

             public void setInitThreshold(Number value) throws IllegalArgumentException
            

设置所有观察对象的初始阈值。
更新观察MBean集合中每个对象的当前阈值。

指定者:

setInitThreshold 在接口 CounterMonitorMBean中

参数:

value - 初始阈值。

抛出:

IllegalArgumentException - 指定的阈值为null或阈值值小于零。

参见:

• getInitThreshold()

getDerivedGauge

             @Deprecated public Number getDerivedGauge()
            

Deprecated.

As of JMX 1.2, replaced by getDerivedGauge(ObjectName)

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

指定者:

getDerivedGauge 在接口 CounterMonitorMBean中

返回:

派生计量。

getDerivedGaugeTimeStamp

             @Deprecated public long getDerivedGaugeTimeStamp()
            

Deprecated.

As of JMX 1.2, replaced by getDerivedGaugeTimeStamp(ObjectName)

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

指定者:

getDerivedGaugeTimeStamp 在接口 CounterMonitorMBean中

返回:

派生计量时间戳。

getThreshold

             @Deprecated public Number getThreshold()
            

Deprecated.

As of JMX 1.2, replaced by getThreshold(ObjectName)

获取观察MBean集合中第一个对象的阈值值。

指定者:

getThreshold 在接口 CounterMonitorMBean中

返回:

阈值数值。

参见:

• setThreshold(java.lang.Number)

setThreshold

             @Deprecated public void setThreshold(Number value) throws IllegalArgumentException
            

Deprecated.

As of JMX 1.2, replaced by setInitThreshold(java.lang.Number)

设置初始阈值数值。

指定者:

setThreshold 在接口 CounterMonitorMBean中

参数:

value - 初始阈值数值。

抛出:

IllegalArgumentException - 指定的阈值为null或阈值数值小于零。

参见:

• getThreshold()

getOffset

             public Number getOffset()
            

获取所有被观察的MBean共同的偏移值。

指定者:

getOffset 在接口 CounterMonitorMBean中

返回:

偏移值。

参见:

• setOffset(java.lang.Number)

setOffset

             public void setOffset(Number value) throws IllegalArgumentException
            

设置所有被观察的MBean共同的偏移值。

指定者:

setOffset 在接口 CounterMonitorMBean中

参数:

value - 偏移值。

抛出:

IllegalArgumentException - 指定的偏移为null或偏移值小于零。

参见:

• getOffset()

getModulus

             public Number getModulus()
            

获取所有被观察的MBean共同的模数值。

指定者:

getModulus 在接口 CounterMonitorMBean中

返回:

模数值。

参见:

• setModulus(java.lang.Number)

setModulus

             public void setModulus(Number value) throws IllegalArgumentException
            

设置所有被观察的MBean共同的模数值。

指定者:

setModulus 在接口 CounterMonitorMBean中

参数:

value - 模数值。

抛出:

IllegalArgumentException - 指定的模数为null或模数值小于零。

参见:

• getModulus()

getNotify

             public boolean getNotify()
            

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

指定者:

getNotify 在接口 CounterMonitorMBean中

返回:

如果计数器监视器在超过阈值时通知，则为true，否则为false。

参见:

• setNotify(boolean)

setNotify

             public void setNotify(boolean value)
            

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

指定者:

setNotify 在接口 CounterMonitorMBean中

参数:

value - 通知开关值。

参见:

• getNotify()

getDifferenceMode

             public boolean getDifferenceMode()
            

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

指定者:

getDifferenceMode 在接口 CounterMonitorMBean中

返回:

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

参见:

• setDifferenceMode(boolean)

setDifferenceMode

             public void setDifferenceMode(boolean value)
            

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

指定者:

setDifferenceMode 在接口 CounterMonitorMBean中

参数:

value - 差值模式标志值。

参见:

• getDifferenceMode()

getNotificationInfo

             public MBeanNotificationInfo[] getNotificationInfo()
            

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

指定者:

getNotificationInfo 在接口 NotificationBroadcaster中

返回:

可能通知的数组。