compact3

java.lang.management

Interface MemoryMXBean

All Superinterfaces:

PlatformManagedObject

public interface MemoryMXBean
extends PlatformManagedObject

Java虚拟机的内存系统的管理界面。

Java虚拟机具有此接口的实现类的单个实例。 实现此接口的实例是可以通过调用ManagementFactory.getMemoryMXBean()方法或从platform MBeanServer方法获得的MXBean 。

该ObjectName用于唯一识别的MXBean为一个MBeanServer内的存储器的系统是：

java.lang:type=Memory

可以通过调用PlatformManagedObject.getObjectName()方法获得。

记忆

Java虚拟机的内存系统管理以下几种内存：

堆

Java虚拟机有一个堆 ，它是运行时数据区域，从中分配了所有类实例和数组的内存。 它是在Java虚拟机启动时创建的。 用于对象的堆内存由被称为垃圾回收器的自动内存管理系统进行回收 。

堆可能是一个固定的大小或可能扩大和缩小。 堆的内存不需要是连续的。

2.非堆存储器

Java虚拟机管理堆以外的内存（称为非堆内存 ）。

Java虚拟机具有在所有线程之间共享的方法区域 。 方法区属于非堆内存。 它存储每个类的结构，例如运行时常量池，字段和方法数据，以及方法和构造函数的代码。 它是在Java虚拟机启动时创建的。

方法区域在逻辑上是堆的一部分，但Java虚拟机实现可以选择不要垃圾收集或压缩它。 类似于堆，方法区域可以是固定大小的，或者可以被扩展和缩小。 方法区域的内存不需要是连续的。

除了方法区域之外，Java虚拟机实现可能需要用于内部处理或优化的内存，这也是非堆内存。 例如，JIT编译器需要内存来存储从Java虚拟机代码转换的本地机器代码以实现高性能。

内存池和内存管理器

Memory pools和memory managers是监视和管理Java虚拟机的内存系统的抽象实体。

内存池代表Java虚拟机管理的内存区域。 Java虚拟机具有至少一个内存池，并且可以在执行期间创建或删除内存池。 内存池可以属于堆或非堆内存。

内存管理器负责管理一个或多个内存池。 垃圾收集器是负责回收由不可达对象占用的内存的一种内存管理器。 Java虚拟机可能具有一个或多个内存管理器。 它可能会在执行期间添加或删除内存管理器。 内存池可以由多个内存管理器管理。

内存使用监控

内存使用是内存系统非常重要的监控属性。 例如，内存使用可能表示：

• 应用程序的内存使用情况，
• 对自动存储器管理系统施加的工作量，
• 潜在的内存泄漏。

可以通过三种方式监视内存使用情况：

• 轮询
• 使用阈值通知
• 集合使用阈值通知

详细情况在指定的MemoryPoolMXBean接口。

内存使用监视机制旨在用于负载平衡或工作负载分配使用。 例如，当应用程序的内存使用量超过某个阈值时，应用程序将停止接收任何新的工作负载。 它不适用于应用程序从低内存条件检测和恢复。

通知

这MemoryMXBean是NotificationEmitter发出两种类型的存储器notifications如果存储池的任一项支持usage threshold或collection usage threshold ，其可以通过调用来确定MemoryPoolMXBean.isUsageThresholdSupported()种MemoryPoolMXBean.isCollectionUsageThresholdSupported()方法。

• usage threshold exceeded notification - 用于通知内存池的内存使用量增加并已达到或超过其usage threshold值。
• collection usage threshold exceeded notification - 用于在Java虚拟机已经花费在回收该内存池中未使用的对象的努力之后通知内存池的内存使用大于或等于其collection usage threshold 。

发出的通知是一个Notification实例，其user data设置为CompositeData ，代表一个MemoryNotificationInfo对象，该对象在构建通知时包含有关内存池的信息。 CompositeData包含MemoryNotificationInfo中描述的属性 。

NotificationEmitter

由返回的MemoryMXBean对象ManagementFactory.getMemoryMXBean()实现NotificationEmitter接口，它允许一个监听到MemoryMXBean为通知侦听内注册。 以下是一个注册MyListener以处理MemoryMXBean发出的通知的示例代码。

 class MyListener implements javax.management.NotificationListener {
     public void handleNotification(Notification notif, Object handback) {
         // handle notification
         ....
     }
 }

 MemoryMXBean mbean = ManagementFactory.getMemoryMXBean();
 NotificationEmitter emitter = (NotificationEmitter) mbean;
 MyListener listener = new MyListener();
 emitter.addNotificationListener(listener, null, null);
 

从以下版本开始：

1.5

另请参见：

ManagementFactory.getPlatformMXBeans(Class) ， JMX Specification. ， Ways to Access MXBeans

方法摘要

Modifier and Type	Method and Description
void	gc() 运行垃圾回收器。
MemoryUsage	getHeapMemoryUsage() 返回用于对象分配的堆的当前内存使用情况。
MemoryUsage	getNonHeapMemoryUsage() 返回Java虚拟机使用的非堆内存的当前内存使用情况。
int	getObjectPendingFinalizationCount() 返回正在等待完成的对象的大致数量。
boolean	isVerbose() 测试是否启用了内存系统的详细输出。
void	setVerbose(boolean value) 启用或禁用内存系统的详细输出。

Methods inherited from interface java.lang.management.PlatformManagedObject

getObjectName

方法详细信息

getObjectPendingFinalizationCount

int getObjectPendingFinalizationCount()

返回正在等待完成的对象的大致数量。

结果

最终定案待处理的大致数字对象。

getHeapMemoryUsage

MemoryUsage getHeapMemoryUsage()

返回用于对象分配的堆的当前内存使用情况。 堆由一个或多个内存池组成。 返回的内存使用量的used和committed大小是所有堆内存池的值的总和，而返回的内存使用量的init和max大小表示堆内存的设置，可能不是所有堆的总和内存池。

返回的内存使用量中使用的内存量是未被收集的活动对象和垃圾对象占用的内存量（如果有的话）。

MBeanServer访问 ：
MemoryUsage的映射类型是CompositeData ，其属性在MemoryUsage中指定 。

结果

表示堆内存使用的MemoryUsage对象。

getNonHeapMemoryUsage

MemoryUsage getNonHeapMemoryUsage()

返回Java虚拟机使用的非堆内存的当前内存使用情况。 非堆存储器由一个或多个内存池组成。 返回的内存使用量的used和committed大小是所有非堆内存池的值的总和，而返回的内存使用量的init和max大小表示非堆内存的设置，可能不是所有非堆内存池的那些。

MBeanServer访问 ：
MemoryUsage的映射类型是CompositeData ，具有MemoryUsage中规定的属性 。

结果

表示非堆内存使用的MemoryUsage对象。

isVerbose

boolean isVerbose()

测试是否启用了内存系统的详细输出。

结果

true如果启用了内存系统的详细输出; false否则。

setVerbose

void setVerbose(boolean value)

启用或禁用内存系统的详细输出。 发出详细信息的详细输出信息和输出流是依赖于实现的。 通常，当Java虚拟机实现在垃圾收集时释放内存时，将打印出一条消息。

此方法的每次调用都可以全局启用或禁用详细输出。

参数

value - true以启用详细输出; false禁用。

异常

SecurityException - 如果安全管理器存在，并且调用者没有ManagementPermission（“控制”）。

gc

void gc()

运行垃圾回收器。 电话gc()有效地等效于通话：

 System.gc()
 

另请参见：

System.gc()