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
-
字段摘要
字段修饰符和类型Field描述protected int已弃用。protected int[]已通知的选定监视器错误。protected static final int大小大于其容量时，监视器阵列的容量自动增加的量。protected String已弃用。没有替代品。protected int观察对象向量中有效组件的数量。protected static final int表示在更改观察到的属性后发生通知的标志。protected static final int表示在更改观察对象或观察属性后发生通知的标志。protected static final int表示在更改观察对象后发生通知的标志。protected static final int此标志用于重置alreadyNotifieds监视器属性。protected static final int表示在更改观察对象或观察属性后发生通知的标志。protected MBeanServer对 MBean 服务的引用。 -
构造方法总结
构造方法 -
方法总结
修饰符和类型方法描述voidaddObservedObject(ObjectName object) 如果此对象尚不存在，则将指定对象添加到观察到的 MBean 集中。booleancontainsObservedObject(ObjectName object) 测试指定对象是否在观察到的 MBean 集中。long获取粒度周期（以毫秒为单位）。获取正在观察的属性。已弃用。从 JMX 1.2 开始，由getObservedObjects()取代返回一个包含被观察对象的数组。booleanisActive()测试监视器 MBean 是否处于活动状态。void允许监视器 MBean 在被 MBean 服务注销后执行任何需要的操作。voidpostRegister(Boolean registrationDone) 允许监视器 MBean 在 MBean 服务中注册后或注册失败后执行所需的任何操作。void允许监视器 MBean 在被 MBean 服务注销之前执行它需要的任何操作。preRegister(MBeanServer server, ObjectName name) 允许监视器 MBean 在注册到 MBean 服务之前执行它需要的任何操作。voidremoveObservedObject(ObjectName object) 从一组观察到的 MBean 中移除指定的对象。voidsetGranularityPeriod(long period) 设置粒度周期（以毫秒为单位）。voidsetObservedAttribute(String attribute) 设置要观察的属性。voidsetObservedObject(ObjectName object) 已弃用。从 JMX 1.2 开始，由addObservedObject(javax.management.ObjectName)取代abstract voidstart()启动监视器。abstract voidstop()停止监视器。
-
字段详细信息
-
capacityIncrement
protected static final int capacityIncrement大小大于其容量时，监视器阵列的容量自动增加的量。- 参见：
-
elementCount
protected int elementCount观察对象向量中有效组件的数量。 -
alreadyNotified
已弃用。相当于alreadyNotifieds[0]。监视已通知的错误。 -
alreadyNotifieds
protected int[] alreadyNotifieds已通知的选定监视器错误。
该数组中的每个元素对应于向量中的一个观察对象。它包含标志
OBSERVED_OBJECT_ERROR_NOTIFIED等的位掩码，指示是否已经为正在监视的 MBean 发送了相应的通知。 -
server
对 MBean 服务的引用。当监视器 MBean 未在 MBean 服务中注册时，此引用为空。此引用在监视器 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
已弃用。没有替代品。保留此字段是为了兼容性，但不应引用。
-
-
构造方法详细信息
-
Monitor
public Monitor()子类调用的构造方法。
-
-
方法详情
-
preRegister
允许监视器 MBean 在注册到 MBean 服务之前执行它需要的任何操作。初始化对 MBean 服务的引用。
- 指定者：
preRegister在接口MBeanRegistration中- 参数：
server- 将在其中注册监视器 MBean 的 MBean 服务。name- 监视器 MBean 的对象名称。- 返回：
- 已注册的监视器 MBean 的名称。
- 抛出：
Exception- 如果出现问题
-
postRegister
允许监视器 MBean 在 MBean 服务中注册后或注册失败后执行所需的任何操作。不在此上下文中使用。
- 指定者：
postRegister在接口MBeanRegistration中- 参数：
registrationDone- 指示 MBean 是否已在 MBean 服务中成功注册。值 false 表示注册阶段失败。
-
preDeregister
允许监视器 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
已弃用。从 JMX 1.2 开始，由getObservedObjects()取代返回观察到的 MBean 集合中第一个对象的对象名称，如果没有这样的对象，则返回null。- 指定者：
getObservedObject在接口MonitorMBean中- 返回：
- 被观察的对象。
- 参见：
-
setObservedObject
已弃用。从 JMX 1.2 开始，由addObservedObject(javax.management.ObjectName)取代从观察到的对象集中移除所有对象，然后添加指定的对象。- 指定者：
setObservedObject在接口MonitorMBean中- 参数：
object- 要观察的对象。- 抛出：
IllegalArgumentException- 指定的对象为空。- 参见：
-
addObservedObject
如果此对象尚不存在，则将指定对象添加到观察到的 MBean 集中。- 指定者：
addObservedObject在接口MonitorMBean中- 参数：
object- 要观察的对象。- 抛出：
IllegalArgumentException- 指定的对象为空。
-
removeObservedObject
从一组观察到的 MBean 中移除指定的对象。- 指定者：
removeObservedObject在接口MonitorMBean中- 参数：
object- 要删除的对象。
-
containsObservedObject
测试指定对象是否在观察到的 MBean 集中。- 指定者：
containsObservedObject在接口MonitorMBean中- 参数：
object- 要检查的对象。- 返回：
true如果指定对象存在，false否则。
-
getObservedObjects
返回一个包含被观察对象的数组。- 指定者：
getObservedObjects在接口MonitorMBean中- 返回：
- 被观察的对象。
-
getObservedAttribute
获取正在观察的属性。
默认情况下不初始化观察到的属性（设置为 null）。- 指定者：
getObservedAttribute在接口MonitorMBean中- 返回：
- 正在观察的属性。
- 参见：
-
setObservedAttribute
设置要观察的属性。
默认情况下不初始化观察到的属性（设置为 null）。- 指定者：
setObservedAttribute在接口MonitorMBean中- 参数：
attribute- 要观察的属性。- 抛出：
IllegalArgumentException- 指定的属性为空。- 参见：
-
getGranularityPeriod
public long getGranularityPeriod()获取粒度周期（以毫秒为单位）。
粒度周期的默认值为 10 秒。- 指定者：
getGranularityPeriod在接口MonitorMBean中- 返回：
- 粒度周期值。
- 参见：
-
setGranularityPeriod
设置粒度周期（以毫秒为单位）。
粒度周期的默认值为 10 秒。- 指定者：
setGranularityPeriod在接口MonitorMBean中- 参数：
period- 粒度周期值。- 抛出：
IllegalArgumentException- 粒度周期小于或等于零。- 参见：
-
isActive
public boolean isActive()- 指定者：
isActive在接口MonitorMBean中- 返回：
true如果监视器 MBean 处于活动状态，false否则。
-
alreadyNotifieds[0]。