JavaTM Platform
Standard Ed. 6

javax.management.monitor
接口 MonitorMBean

所有已知子接口:
CounterMonitorMBean, GaugeMonitorMBean, StringMonitorMBean
所有已知实现类:
CounterMonitor, GaugeMonitor, Monitor, StringMonitor

public interface MonitorMBean

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

从以下版本开始:
1.5

方法摘要
 void addObservedObject(ObjectName object)
          将指定的对象添加到所观察的 MBean 集中。
 boolean containsObservedObject(ObjectName object)
          测试指定的对象是否在所观察的 MBean 集中。
 long getGranularityPeriod()
          获取粒度时段(以毫秒为单位)。
 String getObservedAttribute()
          获取要观察的属性。
 ObjectName getObservedObject()
          已过时。 从 JMX 1.2 开始,由 getObservedObjects() 取代
 ObjectName[] getObservedObjects()
          返回一个包含要观察的对象的数组。
 boolean isActive()
          测试监视器 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) 取代
 void start()
          启动监视器。
 void stop()
          停止监视器。
 

方法详细信息

start

void start()
启动监视器。


stop

void stop()
停止监视器。


addObservedObject

void addObservedObject(ObjectName object)
                       throws IllegalArgumentException
将指定的对象添加到所观察的 MBean 集中。

参数:
object - 要观察的对象。
抛出:
IllegalArgumentException - 指定的对象为 null。

removeObservedObject

void removeObservedObject(ObjectName object)
从所观察的 MBean 集中移除指定的对象。

参数:
object - 要移除的对象。

containsObservedObject

boolean containsObservedObject(ObjectName object)
测试指定的对象是否在所观察的 MBean 集中。

参数:
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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策