java.lang.Object
javax.management.NotificationBroadcasterSupport
javax.management.monitor.Monitor
- 直接已知的子类:
-
CounterMonitor
,GaugeMonitor
,StringMonitor
public abstract class Monitor extends NotificationBroadcasterSupport implements MonitorMBean, MBeanRegistration
定义了所有监视器MBean共有的部分。监视器MBean监视一组被观察MBean共有的属性值。被观察的属性在由粒度周期指定的间隔内进行监视。一个量规值(派生量规)是从被观察属性的值派生出来的。
- 自版本:
- 1.5
-
Field Summary
Modifier and TypeFieldDescriptionprotected 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服务器的引用。 -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addObservedObject
(ObjectName object) 如果此对象尚未存在,则将指定对象添加到被观察MBean集合中。boolean
containsObservedObject
(ObjectName object) 测试指定对象是否在被观察MBean集合中。long
获取粒度周期(以毫秒为单位)。获取正在被观察的属性。已弃用。从JMX 1.2开始,由getObservedObjects()
替代返回包含正在被观察对象的数组。boolean
isActive()
测试监视器MBean是否处于活动状态。void
允许监视器MBean在被MBean服务器注销后执行所需的任何操作。void
postRegister
(Boolean registrationDone) 允许监视器MBean在被MBean服务器注册后或注册失败后执行所需的任何操作。void
允许监视器MBean在被MBean服务器注销之前执行所需的任何操作。preRegister
(MBeanServer server, ObjectName name) 允许监视器MBean在被MBean服务器注册之前执行所需的任何操作。void
removeObservedObject
(ObjectName object) 从被观察MBean集合中移除指定对象。void
setGranularityPeriod
(long period) 设置粒度周期(以毫秒为单位)。void
setObservedAttribute
(String attribute) 设置要观察的属性。void
setObservedObject
(ObjectName object) 已弃用。从JMX 1.2开始,由addObservedObject(javax.management.ObjectName)
替代abstract void
start()
启动监视器。abstract void
stop()
停止监视器。Methods declared in class javax.management.NotificationBroadcasterSupport
addNotificationListener, getNotificationInfo, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification
-
Field Details
-
capacityIncrement
protected static final int capacityIncrement当监视器数组的大小大于其容量时,自动增加监视器数组容量的量。- 参见:
-
elementCount
protected int elementCount被观察对象向量中的有效组件数。 -
alreadyNotified
Deprecated.equivalent toalreadyNotifieds
[0].已经通知的监视器错误。 -
alreadyNotifieds
protected int[] alreadyNotifieds已经通知的选定监视器错误。
此数组中的每个元素对应于向量中的一个被观察对象。它包含标志位掩码
OBSERVED_OBJECT_ERROR_NOTIFIED
等,指示是否已为正在监视的MBean发送了相应的通知。 -
server
MBean服务器的引用。当监视器MBean未在MBean服务器中注册时,此引用为null。在监视器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
Deprecated.No replacement.此字段保留以确保兼容性,但不应引用。
-
-
Constructor Details
-
Monitor
public Monitor()子类调用的构造函数。
-
-
Method Details
-
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
Deprecated.As of JMX 1.2, replaced bygetObservedObjects()
返回观察到的MBean集合中第一个对象的对象名称,如果没有这样的对象则返回null
。- 指定者:
-
getObservedObject
在接口MonitorMBean
- 返回:
- 被观察的对象。
- 参见:
-
setObservedObject
Deprecated.As of JMX 1.2, replaced byaddObservedObject(javax.management.ObjectName)
从观察对象集合中移除所有对象,然后添加指定的对象。- 指定者:
-
setObservedObject
在接口MonitorMBean
- 参数:
-
object
- 要观察的对象。 - 抛出:
-
IllegalArgumentException
- 指定的对象为null。 - 参见:
-
addObservedObject
如果该对象尚未存在,则将指定的对象添加到观察的MBean集合中。- 指定者:
-
addObservedObject
在接口MonitorMBean
- 参数:
-
object
- 要观察的对象。 - 抛出:
-
IllegalArgumentException
- 指定的对象为null。
-
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
- 指定的属性为null。 - 参见:
-
getGranularityPeriod
public long getGranularityPeriod()获取粒度周期(以毫秒为单位)。
粒度周期的默认值为10秒。- 指定者:
-
getGranularityPeriod
在接口MonitorMBean
- 返回:
- 粒度周期值。
- 参见:
-
setGranularityPeriod
设置粒度周期(以毫秒为单位)。
粒度周期的默认值为10秒。- 指定者:
-
setGranularityPeriod
在接口MonitorMBean
- 参数:
-
period
- 粒度周期值。 - 抛出:
-
IllegalArgumentException
- 粒度周期小于或等于零。 - 参见:
-
isActive
public boolean isActive()- 指定者:
-
isActive
在接口MonitorMBean
- 返回:
-
如果监视器MBean处于活动状态则返回
true
,否则返回false
。
-
alreadyNotifieds
[0]。