软件包 javax.management.monitor

请参见：
          描述

软件包 javax.management.monitor 的描述

提供 monitor 类的定义。Monitor 是一个 MBeans，它定期观察一个或多个其他 MBeans 中的属性值。如果某个属性满足特定的条件，则 Monitor 将发出一个 MonitorNotification。当监视器 MBean 定期调用 getAttribute 检索被监视的属性值时，它在 Monitor.start() 调用者的访问控制上下文中执行该操作。

被监视的值可以是一个包含在复合类型中的简单值。例如，java.lang.management 中定义的 MemoryMXBean 具有一个类型为 MemoryUsage 的 HeapMemoryUsage 属性。要监视已用 内存量（由 MemoryUsage 的 used 属性描述），您可以监视 "HeapMemoryUsage.used"。该字符串应该做为 setObservedAttribute 的参数。

用来解释 "HeapMemoryUsage.used" 之类的 ObservedAttribute 的规则如下。假设字符串为 A.e（因此在该例中 A 为 "HeapMemoryUsage"，e 为 "used"）。

首先获得属性 A 的值。称之为 v。按以下方式从 v 中提取值 x：

• 如果 v 为 CompositeData 且 v.get(e) 返回一个值，则 x 就是返回的那个值。
• 如果 v 是数组且 e 为字符串 "length"，则 x 为该数组的长度。
• 如果以上规则无法生成一个值，且类 v (v.getClass()) Introspector.getBeanInfo 包含一个具有名称 e 的 PropertyDescriptor，则 x 为对 v 调用属性读取方法的结果。

第三个规则意味着，如果属性 HeapMemoryUsage 为 MemoryUsage，则监视 "HeapMemoryUsage.used" 将获得调用 MemoryUsage.getUsed() 观察到的值。

如果 ObservedAttribute 包含一个以上的句号 (".")，例如 "ConnectionPool.connectionStats.length"，则迭代地应用上述规则。其中 v 最初是属性 ConnectionPool 的值，x 是在 e 等于 "connectionStats" 的情况下应用上述规则导出的。然后 v 将被设置为此 x，并将在 e 等于 "length" 的情况下导出一个新的 x。

建议使用有效的 Java 标识符作为属性名称，但将属性取名为 HeapMemoryUsage.used 也是可能的。这意味着作为 HeapMemoryUsage.used 的 ObservedAttribute 表示要观察的值可能是该名称的属性，也可能是一个名为 HeapMemoryUsage 的属性内部的属性 used。故出于兼容性原因，当 ObservedAttribute 包含一个句号 (.) 时，监视器将检查是否存在一个名称为完整 ObservedAttribute 字符串（示例中的 HeapMemoryUsage.used）的属性。它实现这一点的方式如下：对被观察的 MBean 调用 getMBeanInfo，并使用给定名称查询被包含的 MBeanAttributeInfo。如果能找到，则它就是被监视的内容。如果正观察多个 MBean，且其中一些有 HeapMemoryUsage.used 属性而另一些却没有时，行为是不确定的。在这种情况下，一个实现可能因此只对其中一个 MBean 调用 getMBeanInfo。如果在监视器激活的情况下检查的结果发生更改，则行为也是不确定的。

《JMX 规范》中详细叙述了监视器的具体行为。下面是有关的概述。

共有三种监视器：

• CounterMonitor 观察整数类型的属性。假定这些属性为非负数，并且单调递增（以指定的模 进行的可能回滚 除外）。每个 observed 属性都具有相关的阈值。当属性超过其阈值时将发出一个通知。

  可以指定一个偏移量 值。当被观察值超过其阈值时，该阈值应按偏移量递增，或者按偏移量的倍数递增，以使其阈值足大于新的被观察值。

  CounterMonitor 可以在不同的模式 下操作。在本模式中，与阈值比较所得的值就是对属性的两次连续观察值之间的差分。

• GaugeMonitor 观察数字类型的属性。每个被观察属性都具有相关的高阈值 和低阈值。

  当 observed 属性超过高阈值时，如果 notify high 标记为 true，则发送一个通知。在尺度值变得小于或等于低阈值之前，后续的超出高阈值的情况不会触发更多的通知。

  当 observed 属性低于低阈值时，如果 notify low 标记为 true，则发送一个通知。在尺度值变得小于或等于高阈值之前，后续的超出低阈值的情况不会触发更多的通知。

  一般情况下，仅设置 notify high 和 notify low 标志中的一个。使用其他阈值来提供滞后 机制，以避免属性值在阈值附近进行小幅度摆动时重复触发通知。

  GaugeMonitor 可以在不同的模式 操作。在本模式中，与高、低阈值相比得出的值就是对属性的两次连续观察值之间的差分。

• StringMonitor 观察类型为 String 的属性。当 observed 属性变得等于和/或不等于指定的字符串时，将发出一个通知。

从以下版本开始：

1.5

另请参见：

Java SE 6 Platform documentation on JMX technology， 特别是 JMX Specification, version 1.4(pdf)。

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