javax.management.monitor
接口 MonitorMBean

所有已知子接口：

CounterMonitorMBean, GaugeMonitorMBean, StringMonitorMBean

所有已知实现类：

CounterMonitor, GaugeMonitor, Monitor, StringMonitor

public interface MonitorMBean

公开监视器 MBeans 的远程管理接口。

从以下版本开始：

1.5

方法摘要

void	addObservedObject(ObjectName object) 将指定的对象添加到所观察的 MBeans 集中。
boolean	containsObservedObject(ObjectName object) 测试指定的对象是否在所观察的 MBeans 集中。
long	getGranularityPeriod() 获取粒度时段（以毫秒为单位）。
String	getObservedAttribute() 获取要观察的属性。
ObjectName	getObservedObject() 已过时。 从 JMX 1.2 开始，由 getObservedObjects() 取代
ObjectName[]	getObservedObjects() 返回一个包含要观察的对象的数组。
boolean	isActive() 测试监视器 MBean 是否处于激活状态。
void	removeObservedObject(ObjectName object) 从所观察的 MBeans 集中移除指定的对象。
void	setGranularityPeriod(long period) 设置粒度时段（以毫秒为单位）。
void	setObservedAttribute(String attribute) 设置要观察的属性。
void	setObservedObject(ObjectName object) 已过时。 从 JMX 1.2 开始，由 addObservedObject(javax.management.ObjectName) 取代
void	start() 启动监视器。
void	stop() 停止监视器。

方法详细信息

start

void start()

启动监视器。

stop

void stop()

停止监视器。

addObservedObject

void addObservedObject(ObjectName object)
                       throws IllegalArgumentException

将指定的对象添加到所观察的 MBeans 集中。

参数：

object - 要观察的对象。

抛出：

IllegalArgumentException - 指定的对象为 null。

removeObservedObject

void removeObservedObject(ObjectName object)

从所观察的 MBeans 集中移除指定的对象。

参数：

object - 要移除的对象。

containsObservedObject

boolean containsObservedObject(ObjectName object)

测试指定的对象是否在所观察的 MBeans 集中。

参数：

object - 要检查的对象。

返回：

如果指定的对象在该集中，则返回 true；否则返回 false。

getObservedObjects

ObjectName[] getObservedObjects()

返回一个包含要观察的对象的数组。

返回：

要观察的对象。

getObservedObject

@Deprecated
ObjectName getObservedObject()

已过时。 从 JMX 1.2 开始，由 getObservedObjects() 取代

获取要观察的对象的对象名称。

返回：

要观察的对象。

另请参见：

setObservedObject(javax.management.ObjectName)

setObservedObject

@Deprecated
void setObservedObject(ObjectName object)

已过时。 从 JMX 1.2 开始，由 addObservedObject(javax.management.ObjectName) 取代

设置由其对象名称标识的要观察的对象。

参数：

object - 要观察的对象。

另请参见：

getObservedObject()

getObservedAttribute

String getObservedAttribute()

获取要观察的属性。

返回：

要观察的属性。

另请参见：

setObservedAttribute(java.lang.String)

setObservedAttribute

void setObservedAttribute(String attribute)

设置要观察的属性。

参数：

attribute - 要观察的属性。

另请参见：

getObservedAttribute()

getGranularityPeriod

long getGranularityPeriod()

获取粒度时段（以毫秒为单位）。

返回：

粒度时段。

另请参见：

setGranularityPeriod(long)

setGranularityPeriod

void setGranularityPeriod(long period)
                          throws IllegalArgumentException

设置粒度时段（以毫秒为单位）。

参数：

period - 粒度时段。

抛出：

IllegalArgumentException - 粒度时段小于或等于零。

另请参见：

getGranularityPeriod()

isActive

boolean isActive()

测试监视器 MBean 是否处于激活状态。在调用 start 方法时，监视器 MBean 被标记为激活状态。在调用 stop 方法时，该标记变为非激活状态。

返回：

如果监视器 MBean 处于激活状态，则返回 true；否则返回 false。