Module  java.management
软件包  java.lang.management

Class MemoryNotificationInfo


  • public class MemoryNotificationInfo
extends Object
    有关内存通知的信息。

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

    • 内存池的名称。
    • 构建通知时内存池的内存使用情况。
    • 构建通知时内存使用量超过阈值的次数。 对于使用阈值通知，此计数将为usage threshold count 。 对于采集阈值通知，此计数将为collection usage threshold count 。

    A CompositeData表示MemoryNotificationInfo对象存储在user data的notification中 。 提供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发出的通知类型有：

    从以下版本开始：
    1.5

    • 字段详细信息

      • 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

    • 构造方法详细信息

      • 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必须包含以下属性：
        The attributes and the types the given CompositeData contains
        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对象。