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 가상 머신이 operating system로부터 요구하는 메모리 관리를 위한 초기 메모리량 (바이트 단위)을 나타낸다. Java 가상 머신은, operating system로부터 추가의 메모리를 요구하거나 시스템 시간의 경과와 함께 메모리를 해제하거나 할 수도 있다. 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 가상 머신이 초기에 메모리 관리에 대해 operating system로부터 요구하는 메모리의 양 (바이트 단위)을 돌려줍니다.
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 가 0 보다 작은 값으로, -1 (은)는 아닌, 또는
• used 또는 committed 가 0 보다 작은 값인, 또는
• used 가 committed 의 값보다 큰, 또는
• committed 가 max 의 값보다 크다. 정의되고 있는 경우는 max

메소드의 상세

getInit

public long getInit()

Java 가상 머신이 초기에 메모리 관리에 대해 operating system로부터 요구하는 메모리의 양 (바이트 단위)을 돌려줍니다. 초기 메모리 사이즈가 미정도리의 경우, 이 메소드는 -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 를 나타내지 않는 경우