JavaTM 2 Platform
Standard Ed. 6

java.lang.management
类 MemoryUsage

java.lang.Object
  继承者 java.lang.management.MemoryUsage

public class MemoryUsage
extends Object

表示内存使用量快照的 MemoryUsage 对象。MemoryUsage 类的实例通常由某些特定的方法构造,这些方法用于获得关于 Java 虚拟机的单个内存池或 Java 虚拟机的全部堆(或非堆)内存的内存使用量信息。

MemoryUsage 对象包含四个值:

以下是内存池的示例图:

        +----------------------------------------------+
        +////////////////           |                  +
        +////////////////           |                  +
        +----------------------------------------------+

        |--------|
           init
        |---------------|
               used
        |---------------------------|
                  committed 
        |----------------------------------------------|
                            max 
 

MXBean 映射

MemoryUsage 映射到 CompositeData,其具有 from 方法中指定的属性。

从以下版本开始:
1.5

构造方法摘要
MemoryUsage(long init, long used, long committed, long max)
          构造一个 MemoryUsage 对象。
 
方法摘要
static MemoryUsage from(CompositeData cd)
          返回由给定 CompositeData 表示的 MemoryUsage 对象。
 long getCommitted()
          返回已提交给 Java 虚拟机使用的内存量(以字节为单位)。
 long getInit()
          返回 Java 虚拟机最初从操作系统请求用于内存管理的内存量(以字节为单位)。
 long getMax()
          返回可以用于内存管理的最大内存量(以字节为单位)。
 long getUsed()
          返回已使用的内存量(以字节为单位)。
 String toString()
          返回此内存使用量的描述性表示形式。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

MemoryUsage

public MemoryUsage(long init,
                   long used,
                   long committed,
                   long max)
构造一个 MemoryUsage 对象。

参数:
init - Java 虚拟机分配的初始内存量(以字节为单位);或者,如果未定义,则为 -1
used - 已经使用的内存量(以字节为单位)。
committed - 已经提交的内存量(以字节为单位)。
max - 可以使用的最大内存量(以字节为单位);或者,如果未定义,则为 -1
抛出:
IllegalArgumentException - 如果
  • initmax 的值为负数,但不是 -1;或者
  • usedcommitted 的值为负数;或者
  • used 大于 committed 的值;或者
  • committed 大于 max 的值(如果 max 已定义)。
方法详细信息

getInit

public long getInit()
返回 Java 虚拟机最初从操作系统请求用于内存管理的内存量(以字节为单位)。如果没有定义初始内存大小,此方法将返回 -1

返回:
内存的初始大小(以字节为单位);如果未定义,则返回 -1

getUsed

public long getUsed()
返回已使用的内存量(以字节为单位)。

返回:
已使用的内存量(以字节为单位)。

getCommitted

public long getCommitted()
返回已提交给 Java 虚拟机使用的内存量(以字节为单位)。此内存量保证可供 Java 虚拟机使用。

返回:
已提交的内存量(以字节为单位)。

getMax

public long getMax()
返回可以用于内存管理的最大内存量(以字节为单位)。如果没有定义最大内存大小,此方法将返回 -1

如果此内存量大于已提交的内存量,则不能保证内存管理能够使用此内存量。即使已使用的内存量没有超过这个最大大小,Java 虚拟机也可能会无法分配内存。

返回:
内存的最大量(以字节为单位);如果未定义,则返回 -1

toString

public String toString()
返回此内存使用量的描述性表示形式。

覆盖:
Object 中的 toString
返回:
该对象的字符串表示形式。

from

public static MemoryUsage from(CompositeData cd)
返回由给定 CompositeData 表示的 MemoryUsage 对象。给定的 CompositeData 必须包含以下属性:

属性名称 类型
init java.lang.Long
used java.lang.Long
committed java.lang.Long
max java.lang.Long

参数:
cd - 表示 MemoryUsageCompositeData
返回:
如果 cd 不为 null,则返回由 cd 表示的 MemoryUsage 对象;否则,返回 null
抛出:
IllegalArgumentException - 如果 cd 不表示具有上述属性的 MemoryUsage

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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