java.lang.management
인터페이스 MemoryMXBean

public interface MemoryMXBean

Java 가상 머신의 메모리시스템의 관리 인터페이스입니다.

Java 가상 머신은 이 인터페이스의 구현 클래스의 단일 인스턴스를 가집니다. 이 인터페이스를 구현하고 있는 인스턴스는 ManagementFactory.getMemoryMXBean() 메서드를 호출해 취득할 수 있다, 혹은 platform MBeanServer 메서드로부터 취득할 수 있는 MXBean 입니다.

MBeanServer 내에서 메모리시스템의 MXBean를 일의에 식별하기 위한 ObjectName는 이하대로입니다.

java.lang:type=Memory

메모리

Java 가상 머신의 메모리시스템은 아래의 종류의 메모리를 관리합니다.

1. heap

Java 가상 머신에는 실행시 데이터 영역인 「heap」가 있습니다. 이 데이터 영역으로부터, 모든 클래스 인스턴스와 배열의 메모리를 할당할 수 있습니다. 「heap」는 Java 가상 머신의 시작시에 작성됩니다. 객체의 히프메모리는 「가비지 컬렉터」라고 하는 자동 메모리 메니지먼트 시스템에 의해 재생됩니다.

heap는 고정 사이즈로 하는 일도, 확장 또는 축소할 수도 있습니다. heap의 메모리는 연속하고 있을 필요는 없습니다.

2. heap 이외의 메모리

Java 가상 머신은 heap와는 다른 메모리 ( 「heap 이외의 메모리」라고 한다)를 관리합니다.

Java 가상 머신에는 모든 thread간에 공유되는 「메서드 영역」이 있습니다. 메서드 영역은 heap 이외의 메모리에 속합니다. 메서드 영역은 실행 완화시간 풀, field data나 메서드 데이터, 메서드와 생성자 코드 등, 클래스마다의 구조를 포함합니다. 메서드 영역은 Java 가상 머신의 시작시에 작성됩니다.

메서드 영역은 논리적이게는 heap의 일부입니다만, 가상 머신의 구현에서는 가비지 컬렉트하지 않게 하거나 컴팩트화하거나 하는 것을 선택할 수 있습니다. heap와 같게, 메서드 영역은 고정 사이즈로 하거나 확장 또는 축소하거나 할 수 있습니다 . 메서드 영역의 메모리는 연속하고 있을 필요는 없습니다.

메서드 영역 외에 Java 가상 머신의 구현에서는 내부 처리나 최적화를 위한 메모리를 필요로 합니다만, 이 메모리도 heap 이외의 메모리에 속합니다. 예를 들어 JIT 컴파일러에서는 고성능을 실현하는데 Java 가상 머신 코드로부터 변환된 네이티브 기계 코드의 메모리가 필요합니다.

메모리프르와 MS-DOS메모리 관리 프로그램

메모리프르와 MS-DOS메모리 관리 프로그램 은 Java 가상 머신의 메모리시스템을 감시 및 관리하는 추상 엔티티입니다.

메모리프르는 Java 가상 머신이 관리하는 메모리 영역을 나타냅니다. Java 가상 머신은 적어도 1개의 메모리프르를 가져, 실행중에 메모리프르를 작성 또는 삭제할 수 있습니다. 메모리프르는 heap 또는 heap 이외의 메모리에 속할 수 있습니다 .

MS-DOS메모리 관리 프로그램 은 1개 이상의 메모리프르의 관리를 담당합니다. 가비지 컬렉터는 도달할 수 없는 객체에 의해 점유 된 메모리의 재생을 담당하는 MS-DOS메모리 관리 프로그램 1 종입니다. Java 가상 머신은 1개 이상의 MS-DOS메모리 관리 프로그램을 가질 수가 있습니다. Java 가상 머신은 실행중에 MS-DOS메모리 관리 프로그램을 추가 또는 삭제할 수 있습니다. 복수의 MS-DOS메모리 관리 프로그램 으로 1개의 메모리프르를 관리할 수 있습니다.

메모리 사용량의 감시

메모리 사용량은 메모리시스템에 있어 극히 중요한 감시 속성입니다. 예를 들어 메모리 사용량은 이하를 나타냅니다.

• 어플리케이션의 메모리 사용량
• 자동 메모리 메니지먼트 시스템에 걸려 있는 작업 부하
• 가능성이 있는 메모리 리크

메모리 사용량은 다음의 3개의 방법으로 감시할 수 있습니다.

• 폴링
• 사용량의해 귀의치 통지
• 컬렉션 사용량의해 귀의치 통지

자세한 것은, MemoryPoolMXBean 인터페이스로 지정됩니다.

메모리 사용량 감시 메카니즘은 load balancing 또는 작업 load sharing에 사용하는 것을 목적으로 하고 있습니다. 예를 들어 어플리케이션은 메모리 사용이 일정한의해 귀의치를 넘었을 때에 새로운 작업 부하의 수락을 정지합니다. 메모리 사용량 감시 메카니즘은 어플리케이션을 위해서 메모리 부족 조건을 검출하거나 메모리 부족 조건으로부터 회복하거나하기 위한 것이 아닙니다.

통지

MemoryPoolMXBean.isUsageThresholdSupported() 메서드와 MemoryPoolMXBean.isCollectionUsageThresholdSupported() 메서드를 호출해 판정할 수 있는사용량의해 귀의치나컬렉션 사용량의해 귀의치를 메모리프르의 1개가 지원하는인 경우, 이 MemoryMXBean는 2 종류의 메모리통지를 발행하는 NotificationEmitter 입니다.

• 사용량의해 귀의치 초과 통지는 메모리프르의 메모리 사용량이 증가해, 사용량의해 귀의치에 이르렀는지, 넘은 것을 통지합니다.
• 컬렉션 사용해 귀의치 초과 통지는 Java 가상 머신이 메모리프르로 사용하지 않는 객체의 리사이클에 최선을 다한뒤 메모리프르의 메모리 사용량이컬렉션 사용량의해 귀의치 이상인 것을 통지합니다.

발행된 통지는 Notification 인스턴스입니다. 이 인스턴스의 사용자 데이터는 통지가 구축되었을 때의 메모리프르에 관한 정보를 포함한 MemoryNotificationInfo 객체를 나타내는 CompositeData 로 설정되어 있습니다. CompositeData 은, MemoryNotificationInfo에 기술된 속성을 포함합니다.

NotificationEmitter

ManagementFactory.getMemoryMXBean() 에 의해 리턴된 MemoryMXBean 객체는 리스너를 통지 리스너로서 MemoryMXBean 내에서 등록할 수 있도록 하는 NotificationEmitter 인터페이스를 구현합니다. 이하는 MemoryMXBean에 의해 발행된 통지를 처리하기 위한 MyListener를 등록하는 샘플 코드입니다.

 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

관련 항목:

JMX Specification, Ways to Access MXBeans

메서드 개요

void	gc () 가비지 컬렉터를 실행합니다.
MemoryUsage	getHeapMemoryUsage () 객체의 할당에 사용되는 heap의 현재의 메모리 사용량을 리턴합니다.
MemoryUsage	getNonHeapMemoryUsage () Java 가상 머신에 의해 사용되는 heap 이외의 현재의 메모리 사용량을 리턴합니다.
int	getObjectPendingFinalizationCount () 파이나라이즈를 중단하고 있는 객체의 대략의 수를 리턴합니다.
boolean	isVerbose () 메모리시스템의 상세 출력이 유효한가 어떤가를 테스트합니다.
void	setVerbose (boolean value) 메모리시스템의 상세 출력을 유효 또는 무효로 합니다.

메서드의 상세

getObjectPendingFinalizationCount

int getObjectPendingFinalizationCount()

파이나라이즈를 중단하고 있는 객체의 대략의 수를 리턴합니다.

반환값:

파이나라이즈를 중단하고 있는 객체의 대략의 수

getHeapMemoryUsage

MemoryUsage  getHeapMemoryUsage()

객체의 할당에 사용되는 heap의 현재의 메모리 사용량을 리턴합니다. heap는 1개 이상의 메모리프르로 구성되어 있습니다. 리턴된 메모리 사용량의 used와 committed 사이즈는 모든 히프메모리프르의 메모리 사용량의 합계, init와 max 사이즈는 히프메모리의 설정 (모든 히프메모리프르의 합계와 같다고는 할 수 없다)을 나타냅니다.

리턴된 메모리 사용량에 있어서의 사용된 메모리의 양은 라이브 객체와 수집되지 않았던 가비지 객체 (존재하는 경우)의 양쪽 모두에 의해 점유 된 메모리의 양입니다.

MBeanServer 액세스:
MemoryUsage 맵형은, MemoryUsage 로 지정된 속성을 가지는 CompositeData 입니다.

반환값:

히프메모리 사용량을 나타내는 MemoryUsage 객체

getNonHeapMemoryUsage

MemoryUsage  getNonHeapMemoryUsage()

Java 가상 머신에 의해 사용되는 heap 이외의 현재의 메모리 사용량을 리턴합니다. heap 이외의 메모리는 1개 이상의 메모리프르로 구성되어 있습니다. 리턴된 메모리 사용량의 used와 committed 사이즈는 heap 이외의 메모리프르 모든 메모리 사용량의 합계, init와 max 사이즈는 heap 이외의 메모리의 설정 (heap 이외의 메모리프르 모든 합계와 같다고는 할 수 없다)을 나타냅니다.

MBeanServer 액세스:
MemoryUsage 맵형은, MemoryUsage 로 지정된 속성을 가지는 CompositeData 입니다.

반환값:

heap 이외의 메모리 사용량을 나타내는 MemoryUsage 객체

isVerbose

boolean isVerbose()

메모리시스템의 상세 출력이 유효한가 어떤가를 테스트합니다.

반환값:

메모리시스템의 상세 출력이 유효한 경우는 true. 유효하지 않은 경우는 false

setVerbose

void setVerbose(boolean value)

메모리시스템의 상세 출력을 유효 또는 무효로 합니다. 상세 출력 정보와 상세 정보의 출력처의 출력 스트림은 구현에 응해 다릅니다. 일반적으로 Java 가상 머신의 구현은 가비지 컬렉션으로 메모리를 해방할 때마다 메세지를 출력합니다.

이 메서드의 호출마다, 상세 출력은 포괄적으로 유효 또는 무효가 됩니다.

파라미터:

value - 상세 출력을 유효하게 하는 경우는 true, 무효로 하는 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("control")를 가지지 않는 경우

gc

void gc()

가비지 컬렉터를 실행합니다. gc() 호출의 동작은 실제로는 다음의 호출과 같습니다.

 System.gc() 

관련 항목:

System.gc()