java.lang.management
클래스 MemoryUsage

java.lang.Object 
  java.lang.management.MemoryUsage

public class MemoryUsage
extends Object 

MemoryUsage 객체는 메모리 사용량의 snapshot를 나타냅니다. 보통, MemoryUsage 클래스의 인스턴스는 Java 가상 머신의 개개의 메모리프르나 Java 가상 머신의 heap 또는 heap 이외의 메모리에 관한 메모리 사용량 정보를 총괄해 얻는 데 사용되는 메서드에 의해 성립되고 있습니다.

MemoryUsage 객체에는 아래의 4개의 값이 있습니다.

init	시작중에 Java 가상 머신이 OS 로부터 요구하는 메모리 메니지먼트를 위한 초기 메모리량 (바이트 단위)을 나타낸다. Java 가상 머신은 OS 로부터 추가의 메모리를 요구하거나 시스템 시간의 경과와 함께 메모리를 해방하거나 할 수도 있다. init 값은 지정하지 않아도 상관없는
used	현재 사용되고 있는 메모리의 양 (바이트 단위)을 나타내는
committed	Java 가상 머신을 사용할 수 있는 것이 보증되고 있는 메모리의 양 (바이트 단위)을 나타낸다. 위탁된 메모리의 양은 시간의 경과와 함께 변화 (증감)한다. Java 가상 머신은 시스템에 대해서 메모리를 해방할 수 있다. committed는 init 미만인 일도 가능. committed는 항상 used 이상이 되는
max	메모리 메니지먼트에 사용할 수 있는 최대 메모리량 (바이트 단위)을 나타낸다. 이 값은 정의하지 않는 것도 가능. 정의하는 경우, 메모리의 최대량은 시간의 경과와 함께 변화할 가능성이 있다. max가 정의되었을 경우, used 및 committed 메모리의 양은 항상 max 이하가 된다. used <= max가 true인 경우에서도 used > committed 등과 같이, used 메모리를 늘리려고 하면 메모리의 할당이 실패할 가능성이 있다 (예를 들어 시스템의 가상 메모리가 적은 경우)

메모리프르의 예를 이하에 나타냅니다.

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

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

MXBean 매핑

MemoryUsage는 from 메서드로 지정된 속성을 가지는 CompositeData에 매핑 됩니다.

도입된 버전 :

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 가상 머신이 초기에 메모리 메니지먼트에 대해 OS 로부터 요구하는 메모리의 양 (바이트 단위)을 리턴합니다.
long	getMax () 메모리 메니지먼트에 사용할 수 있는 최대 메모리량 (바이트 단위)을 리턴합니다.
long	getUsed () used 메모리의 양 (바이트 단위)을 리턴합니다.
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 - used 메모리의 양 (바이트 단위)

committed - committed 메모리의 양 (바이트 단위)

max - 사용 가능한 최대 메모리량. 정의되어 있지 않은 경우는 -1

예외:

IllegalArgumentException - 다음의 조건이 성립하는 경우:

• init 또는 max가 잘못된 값 으로-1는 아니다
• used 또는 committed가 잘못된 값이다
• used가 committed 값보다 크다
• committed가 max 값보다 크다 (max가 정의되고 있는 경우)

메서드의 상세

getInit

public long getInit()

Java 가상 머신이 초기에 메모리 메니지먼트에 대해 OS 로부터 요구하는 메모리의 양 (바이트 단위)을 리턴합니다. 초기 메모 리사이즈가 미정도리의 경우, 이 메서드는 -1을 리턴합니다.

반환값:

메모리의 초기 사이즈 (바이트 단위). 미정도리의 경우는 -1

getUsed

public long getUsed()

used 메모리의 양 (바이트 단위)을 리턴합니다.

반환값:

used 메모리의 양 (바이트 단위)

getCommitted

public long getCommitted()

Java 가상 머신이 사용하도록 위탁된 메모리의 양 (바이트 단위)을 리턴합니다. 이 메모리의 양은 Java 가상 머신이 사용하도록 보증된 양입니다.

반환값:

committed 메모리의 양 (바이트 단위)

getMax

public long getMax()

메모리 메니지먼트에 사용할 수 있는 최대 메모리량 (바이트 단위)을 리턴합니다. 최대 메모 리사이즈가 미정도리의 경우, 이 메서드는 -1을 리턴합니다.

이 메모리의 양이 committed 메모리의 양보다 큰 경우, 이 메모리량은 메모리 메니지먼트에 이용할 수 있는 것이 보증되지 않습니다. used 메모리의 양이 이 최대 사이즈를 넘지 않는 경우에서도, Java 가상 머신은 메모리의 할당해에 실패할 가능성이 있습니다.

반환값:

메모리의 최대량 (바이트 단위). 미정도리의 경우는 -1

toString

public String  toString()

이 메모리의 사용량의 설명적 표현을 리턴합니다.

오버라이드(override):

클래스 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 - MemoryUsage를 나타내는 CompositeData

반환값:

cd가 null가 아닌 경우는 cd에 의해 나타내지는 MemoryUsage 객체. 그렇지 않은 경우는 null

예외:

IllegalArgumentException - cd가 상기의 속성을 가지는 MemoryUsage를 나타내지 않는 경우