Java java.lang.management 类 MemoryNotificationInfo（JDK5）

所有类

java.lang.management
类 MemoryNotificationInfo

java.lang.Object
  java.lang.management.MemoryNotificationInfo

public class MemoryNotificationInfo
   
   
   
   
   
extends Object
   
   
   
   
   

关于内存通知的信息。

当 Java 虚拟机检测到内存池的内存使用量超过了阈值时，MemoryMXBean 将发出内存通知。发出的通知将包含关于检测到的情况的内存通知信息：

• 内存池的名称。
• 构造通知时内存池的内存使用量。
• 构造通知时，内存使用量超过阈值的次数。对于使用量阈值通知，此计数将为使用量阈值计数。对于集合使用量阈值通知，此计数将为集合使用量阈值计数。

表示 MemoryNotificationInfo 对象的 CompositeData 存储在通知的用户数据中。提供了表单方法将 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 发出的通知类型为：

• 使用量阈值超过通知。
  当内存池的内存使用量增加，达到或超过其使用量阈值，将发出此通知。后续的使用量阈值超过情况不会导致更多的通知，一直到内存使用量返回到小于使用量阈值的状态为止。

• 集合使用量阈值超过通知。
  当 Java 虚拟机对内存池中不使用的对象进行了回收工作之后，内存池的内存使用量大于或等于其集合使用量阈值时，将发出此通知。

从以下版本开始：

1.5

MEMORY_THRESHOLD_EXCEEDED

public static final String MEMORY_THRESHOLD_EXCEEDED

表示内存池的内存使用量已达到或超过其使用量阈值的通知类型。此通知由 MemoryMXBean 发出。后续的使用量阈值超过情况不会导致更多的通知，一直到内存使用量返回到小于使用量阈值的状态为止。此通知类型的值为 java.management.memory.threshold.exceeded。

另请参见：

常量字段值

MEMORY_COLLECTION_THRESHOLD_EXCEEDED

public static final String MEMORY_COLLECTION_THRESHOLD_EXCEEDED

表示当 Java 虚拟机对内存池中的不使用的对象进行了回收工作之后，内存池的内存使用量大于或等于其集合使用量阈值的通知类型。此通知由 MemoryMXBean 发出。此通知类型的值为 java.management.memory.collection.threshold.exceeded。

另请参见：

常量字段值

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()

返回构造通知时内存使用量超过阈值的次数。对于使用量阈值通知，此计数将为阈值计数。对于集合使用量阈值通知，此计数将为集合使用量阈值计数。

返回：

构造通知时，内存使用量超过阈值的次数。

from

public static MemoryNotificationInfo from(CompositeData cd)

返回由给定 CompositeData 表示的 MemoryNotificationInfo 对象。此给定的 CompositeData 必须包含以下属性：

属性名称	类型
poolName	java.lang.String
usage	javax.management.openmbean.CompositeData
count	java.lang.Long

参数：

cd - 表示 MemoryNotificationInfo 的 CompositeData

返回：

如果 cd 不为 null，则返回由 cd 表示的 MemoryNotificationInfo 对象；否则，返回 null。

抛出：

IllegalArgumentException - 如果 cd 不表示 MemoryNotificationInfo 对象。