compact3

java.lang.management

Class MemoryNotificationInfo

java.lang.Object

java.lang.management.MemoryNotificationInfo

public class MemoryNotificationInfo
extends Object

关于内存通知的信息。

一个内存通知发出时MemoryMXBean java虚拟机检测到一个内存池的内存使用量超过阈值。所发出的通知将包含有关所检测到的状态的内存通知信息：

• 内存池的名称。
• 当构造通知时内存池的内存使用情况。
• 当通知被构造时，内存使用量已经越过了一个阈值的次数。使用阈值的通知，这算是usage threshold count。收藏门槛的通知，这算是collection usage threshold count。

一个CompositeData代表MemoryNotificationInfo对象存储在一个notification的user data。的from方法从CompositeData转换为MemoryNotificationInfo对象。例如:

      Notification notif;

      // receive the notification emitted by MemoryMXBean and set to notif
      ...

      String notifType = notif.getType();
      if (notifType.equals(MemoryNotificationInfo.MEMORY_THRESHOLD_EXCEEDED) ||
          notifType.equals(MemoryNotificationInfo.MEMORY_COLLECTION_THRESHOLD_EXCEEDED)) {
          // retrieve the memory notification information
          CompositeData cd = (CompositeData) notif.getUserData();
          MemoryNotificationInfo info = MemoryNotificationInfo.from(cd);
          ....
      }
 

MemoryMXBean发出通知的类型：

• 一个usage threshold exceeded notification。
  this通知将被排放在一个内存池的内存使用量增加，已达到或超过其 usage threshold价值。随后的使用阈值的交叉不导致进一步的通知，直到内存使用已返回，成为小于使用阈值。

• 一个collection usage threshold exceeded notification。
  this通知将被排放在一个内存池的内存使用量大于或等于其 collection usage threshold在java虚拟机中，内存池未使用的对象回收已花费的努力。

从以下版本开始：

一点五

Field Summary

Fields

Modifier and Type	Field and Description
static String	MEMORY_COLLECTION_THRESHOLD_EXCEEDED 通知类型表示一个内存池的内存使用量大于或等于其 collection usage threshold在java虚拟机中，内存池未使用的对象回收已花费的努力。
static String	MEMORY_THRESHOLD_EXCEEDED 通知类型表示一个内存池的内存使用率已经达到或超过其 usage threshold价值。

构造方法摘要

构造方法

Constructor and Description
MemoryNotificationInfo(String poolName, MemoryUsage usage, long count) 构建了一个 MemoryNotificationInfo对象。

方法摘要

Modifier and Type	Method and Description
static MemoryNotificationInfo	from(CompositeData cd) 返回一个对象的 CompositeData代表了 MemoryNotificationInfo。
long	getCount() 返回当通知被构造时内存使用量已经过了一个阈值的次数。
String	getPoolName() 返回触发此通知的内存池的名称。
MemoryUsage	getUsage() 当这个通知被构造时，返回内存池的内存使用情况。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MEMORY_THRESHOLD_EXCEEDED

public static final String MEMORY_THRESHOLD_EXCEEDED

通知类型表示一个内存池的内存使用率已经达到或超过其 usage threshold价值。这个通知发出 MemoryMXBean，随后使用阈值交叉不会引起进一步的通知之前，内存的使用已经恢复成为小于使用阈值。此通知类型的值是 java.management.memory.threshold.exceeded。

另请参见：

Constant Field Values

MEMORY_COLLECTION_THRESHOLD_EXCEEDED

public static final String MEMORY_COLLECTION_THRESHOLD_EXCEEDED

通知类型表示一个内存池的内存使用量大于或等于其 collection usage threshold在java虚拟机中，内存池未使用的对象回收已花费的努力。这个通知发出 MemoryMXBean。此通知类型的值是 java.management.memory.collection.threshold.exceeded。

另请参见：

Constant Field Values

Constructor Detail

MemoryNotificationInfo

public MemoryNotificationInfo(String poolName,
                              MemoryUsage usage,
                              long count)

构建了一个 MemoryNotificationInfo对象。

参数

poolName -内存池触发该通知的名称。

usage -内存池的内存使用情况。

count的阈值交叉数。

方法详细信息

getPoolName

public String getPoolName()

返回触发此通知的内存池的名称。内存池的使用已经跨越了一个阈值。

结果

触发此通知的内存池的名称。

getUsage

public MemoryUsage getUsage()

当这个通知被构造时，返回内存池的内存使用情况。

结果

当这个通知被构造时内存池的内存使用。

getCount

public long getCount()

返回当通知被构造时内存使用量已经过了一个阈值的次数。使用阈值的通知，这算是 threshold count。收藏门槛的通知，这算是 collection usage threshold count。

结果

当通知被构造时，内存使用量已经越过了一个阈值的次数。

from

public static MemoryNotificationInfo from(CompositeData cd)

返回一个给定的 CompositeData代表 MemoryNotificationInfo对象。给定的 CompositeData必须包含以下属性：

Attribute Name	Type
poolName	java.lang.String
usage	javax.management.openmbean.CompositeData
count	java.lang.Long

参数

cd - CompositeData代表 MemoryNotificationInfo

结果

一个 MemoryNotificationInfo对象代表的 cd如果 cd不 null； null否则。

异常

IllegalArgumentException -如果 cd并不代表 MemoryNotificationInfo对象。