|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 차의 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | 생성자 | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
public interface MemoryPoolMXBean
메모리프르의 관리 인터페이스입니다. 메모리프르는 Java 가상 머신에 의해 관리되는 메모리 리소스를 나타내, 1개
이상 MS-DOS메모리 관리 프로그램에 의해 관리됩니다.
Java 가상 머신은 이 인터페이스의 구현 클래스의 1개
이상의 인스턴스를 가집니다. 이 인터페이스를 구현하고 있는 인스턴스는 ManagementFactory.getMemoryPoolMXBeans() 메서드를 호출해 취득할 수 있다, 혹은 platform MBeanServer 메서드로부터 취득할 수 있는 MXBean 입니다.
MBeanServer 내에서 메모리프르의 MXBean를 일의에 식별하기 위한 ObjectName는 이하대로입니다.
java.lang:type=MemoryPool , name=pool's name
Java 가상 머신은 객체 할당용의 heap를 가져, 메서드 영역과 Java 가상 머신의 실행용의 heap 이외의 메모리도 보관 유지하고 있습니다. Java 가상 머신은 1개 이상의 메모리프르를 보유할 수 있습니다. 각 메모리프르는 아래의 형태의 어느 쪽인가의 메모리 영역을 나타냅니다.
getUsage() 메서드는 메모리프르의 현재의 대략의 사용량을 제공합니다. 가비지 컬렉트된 메모리프르의 경우, 사용된 메모리의 양에는 「도달 가능한」객체와 「도달 불가능한」객체의 양쪽 모두를 포함한, 메모리프르의 모든 객체가 차지하는 메모리가 포함됩니다.
일반적으로 이 메서드는 부하의 적은 조작으로 대략의 메모리 사용량을 취득합니다. 객체가 연속해 팩 되지 않는 경우 등, 일부의 메모리프르에서는 이 메서드는 현재의 메모리 사용량을 판정하는데 얼마인가의 계산을 필요로 하는 부하의 큰 조작이 될 가능성이 있습니다. 구현에서는 이러한 케이스를 문서화할 필요가 있습니다.
getPeakUsage() 메서드에 의해 돌려주고져resetPeakUsage() 메서드를 호출해 리셋 됩니다.
setUsageThreshold 메서드를 사용해 설정할 수 있습니다.의해 귀의값이 정의 값으로 설정되면, 이 메모리프르로 사용량의해 귀의치의 초과 체크가 유효하게 됩니다. 사용량의해 귀의값이 제로로 설정되면, 이 메모리프르로 사용량의해 귀의치의 초과 체크가 무효가 됩니다. MemoryPoolMBean#isUsageThresholdSupported 메서드를 사용해, 이 기능이 지원
되고 있는지를 판정할 수 있습니다.
Java 가상 머신은 최적인 시기 (일반적으로 가비지 컬렉션시)에
사용량의해 귀의치 초과 체크를 메모리프르 마다 실행합니다. 각 메모리프르는 메모리프르 사용량이의해 귀의치를 초과하고 있는 것을 Java 가상 머신이 검출할 때마다 증가하는 usage threshold count를
보관 유지하고 있습니다.
이 관리 가능한 사용량의해 귀의치 속성은 메모리 사용량의 증가 경향을 낮은 오버헤드로 감시하도록 설계되고 있습니다. 사용량의해 귀의치는 일부의 메모리프르에 적합하지 않는 경우가 있습니다. 예를 들어 많은 Java 가상 머신 구현으로 사용되는 공통의 가비지 컬렉터인 세대별 가비지 컬렉터는 연령으로 객체를 구분해, 2 세대 이상을 관리합니다. 대부분의 객체는 「가장 젊은 세대」(젊은 메모리프르)에 할당할 수 있습니다. 젊은 메모리프르는 가득 되도록 설계되고 있습니다. 또, 가비지 컬렉션시에 대부분의 경우 도달 불가능한 단기간 가동의 객체가 수용되기 때문에 젊은 메모리프르를 수집하면, 메모리 공간의 대부분이 해방됩니다. 이 케이스에서는 젊은 메모리프르가 사용량의해 귀의치를 지원 하지 않는 편이 적절합니다. 더해, 사용량의의해 귀의치와 비교할 때의 오버헤드는 객체 할당의 코스트보다 비싸게 들므로 1개의 메모리프르에의 객체의 할당의 코스트가 극히 낮은 경우 (예, 원자 포인터 교환 등), Java 가상 머신은 메모리프르의 사용량의해 귀의치를 지원 하지 않습니다.
시스템의 메모리 사용량은, 폴링이나해 귀의치 통지의 메카니즘을 사용해 감시할 수 있습니다.
어플리케이션에서는 모든 메모리프르에 대해서 getUsage() 메서드를 호출하는지, 사용량의해 귀의치를 지원하는 메모리프르에 대해서 isUsageThresholdExceeded() 메서드를 호출해 연속적으로 어플리케이션의 메모리 사용량을 감시할 수 있습니다. 이하는 태스크의 배분과 처리에 특화한 thread를 가지는 샘플 코드의 예입니다. 이 샘플 코드는 어느 구간에서도 메모리 사용량에 근거해 새로운 태스크를 받아들여 처리할지 어떨지를 판정합니다. 메모리 사용량이 사용량의해 귀의치를 넘었을 경우, 이 샘플 코드는 모든 미처리의 태스크를 다른 가상 머신에 재배분해, 메모리 사용량이 사용량의해 귀의치 이하에 돌아올 때까지 새로운 태스크의 수락을 정지합니다.
// Assume the usage threshold is supported for this pool.
// Set the threshold to myThreshold above which no new tasks
// should be taken.
pool.setUsageThreshold(myThreshold);
....
boolean lowMemory = false;
while (true) {
if (pool.isUsageThresholdExceeded()) {
// potential low memory, so redistribute tasks to other VMs
lowMemory = true;
redistributeTasks();
// stop receiving new tasks
stopReceivingTasks();
} else {
if (lowMemory) {
// resume receiving tasks
lowMemory = false;
resumeReceivingTasks();
}
// processing outstanding task
...
}
// sleep for sometime
try {
Thread.sleep(sometime);
} catch (InterruptedException e) {
...
}
}
getUsageThresholdCount() 메서드에 의해 리턴된 사용량의해 귀의치 카운트를 사용해, 리턴된 메모리 사용량이 2개의 getUsageThresholdCount() 폴간에 의해 귀의치 이하일지 어떨지를 판정할 수 있습니다. 이하는 메모리프르가 메모리 부족의 경우에 어떠한 액션을 실행해, 액션 처리중에 메모리 사용량의 변화를 무시하는 샘플 코드입니다.
// Assume the usage threshold is supported for this pool.
// Set the threshold to myThreshold which determines if
// the application will take some action under low memory condition.
pool.setUsageThreshold(myThreshold);
int prevCrossingCount = 0;
while (true) {
// A busy loop to detect when the memory usage
// has exceeded the threshold.
while (! pool.isUsageThresholdExceeded() ||
pool.getUsageThresholdCount() == prevCrossingCount) {
try {
Thread.sleep(sometime)
} catch (InterruptException e) {
....
}
}
// Do some processing such as check for memory usage
// and issue a warning
....
// Gets the current threshold count. The busy loop will then
// ignore any crossing of threshold happens during the processing.
prevCrossingCount = pool.getUsageThresholdCount();
}
사용량의해 귀의치 통지는 MemoryMXBean 에 의해 발행됩니다. 메모리프르의 메모리 사용량이 사용량의해 귀의치에 이르렀는지 넘은 것을 Java 가상 머신이 검출하면, 가상 머신은 MemoryMXBean를 트리거 해사용량의해 귀의치 초과 통지를 발행합니다. 사용량이의해 귀의치 미만이 되어, 다시 초과할 때까지, 다른 사용량의해 귀의치 초과 통지는 생성되지 않습니다.
아래의 샘플 코드는 전술의 최초의 샘플 코드와 같은 논리를 구현하고 있습니다만, 폴링은 아니고, 사용량의해 귀의치 통지 메카니즘을 사용해 메모리 부족 조건을 검출하고 있습니다. 이 샘플 코드에서는 통지의 수취에의해 통지 리스너는 미처리 태스크의 재배분, 태스크의 수취의 정지, 혹은 받아 태스크의 재개등의 실제의 액션을 실행하도록 다른 thread에 통지합니다. handleNotification 메서드는 극히 소량의 작업을 실행해 지연없이 값을 돌려주고, 이후의 통지의 배포로 지연이 생기지 않도록 설계될 필요가 있습니다. 시간이 걸리는 액션은 다른 thread에 의해 실행될 필요가 있습니다. 통지 리스너는 복수의 thread에 의해 불려 갈 수가 있습니다. 따라서, 리스너가 실행하는 태스크는 적절히 동기화 될 필요가 있습니다.
class MyListener implements javax.management.NotificationListener {
public void handleNotification(Notification notification, Object handback) {
String notifType = notification.getType();
if (notifType.equals(MemoryNotificationInfo.MEMORY_THRESHOLD_EXCEEDED)) {
// potential low memory, notify another thread
// to redistribute outstanding tasks to other VMs
// and stop receiving new tasks.
lowMemory = true;
notifyAnotherThread(lowMemory);
}
}
}
// Register MyListener with MemoryMXBean
MemoryMXBean mbean = ManagementFactory.getMemoryMXBean();
NotificationEmitter emitter = (NotificationEmitter) mbean;
MyListener listener = new MyListener();
emitter.addNotificationListener(listener, null, null);
// Assume this pool supports a usage threshold.
// Set the threshold to myThreshold above which no new tasks
// should be taken.
pool.setUsageThreshold(myThreshold);
// Usage threshold detection is enabled and notification will be
// handled by MyListener. Continue for other processing.
....
MemoryMXBean가
의해 귀의치 통지를 발행하는 시기나 통지가 배포되는 시기에 대한 보증은 없습니다. 통지 리스너가 불려가
면, 메모리프르의 메모리 사용량이 사용량의해 귀의치를 2회 이상 넘은 가능성이 있습니다. MemoryNotificationInfo.getCount() 메서드는 통지가 구축된 시점에서 메모리 사용량이 사용량의해 귀의치를 넘은 회수를 리턴합니다. 이 회수를, getUsageThresholdCount() 메서드에 의해 리턴된 현재의 사용량의해 귀의치 카운트와 비교해, 이러한 상황이 발생했는지 어떠했는지를 판정할 수 있습니다.
컬렉션 사용량의해 귀의치 초과 통지가 발행되도록, 컬렉션 사용량의해 귀의치를 사용해, 이 일부의 바이트수에 값을 설정할 수 있습니다. 더해, 컬렉션 사용량의해 귀의치 카운트가 늘려집니다.
isCollectionUsageThresholdSupported() 메서드를 사용해, 이 기능이 지원
되고 있는지를 판정할 수 있습니다.
Java 가상 머신은 컬렉션 사용량의해 귀의치 체크를 메모리프르 마다 실행합니다. 이 체크는 컬렉션 사용량의해 귀의값이 정의 값으로 설정되어 있는 경우에 유효하게 됩니다. 컬렉션 사용량의해 귀의값이 제로로 설정되었을 경우, 이 체크는 이 메모리프르로 무효가 됩니다. 기본값는 제로입니다. Java 가상 머신은 가비지 컬렉션시에 컬렉션 사용량의해 귀의치 체크를 실행합니다.
일부의 가비지 컬렉트된 메모리프르에서는 컬렉션 사용량의해 귀의치를 지원 하지 않게 선택할 수 있습니다. 예를 들어 메모리프르는 연속적인 병행 가비지 컬렉터인 만큼 보다 관리됩니다. 사용하지 않는 객체를 병행 가비지 컬렉터가 동시에 재생하고 있는 동안에 어떠한 thread에의해 이 메모리프르에 객체를 할당할 수 있습니다 . 충분히 정의된 가비지 컬렉션 시간 (메모리 사용량을 체크하는데 최적인 시간)이 없는 한, 컬렉션 사용량의해 귀의치를 지원 해서는 안됩니다.
컬렉션 사용량의해 귀의치는 Java 가상 머신이 메모리 공간의 재생에 최선을 다한뒤 메모리 사용량을 감시하도록 설계되고 있습니다. 사용량의해 귀의치로 설명한 폴링 및의해 귀의치 통지 메카니즘에의해 같은 방법으로 컬렉션 사용량을 감시할 수 있습니다.
| 메서드 개요 | |
|---|---|
MemoryUsage |
getCollectionUsage ()
Java 가상 머신이 이 메모리프르로 사용되지 않는 객체의 리사이클에 마지막에 최선을 다한 뒤의 메모리 사용량을 리턴합니다. |
long |
getCollectionUsageThreshold ()
이 메모리프르의 컬렉션 사용량의해 귀의치 (바이트 단위)를 리턴합니다. |
long |
getCollectionUsageThresholdCount ()
메모리 사용량이 컬렉션 사용량의해 귀의치를 넘은 것을 Java 가상 머신이 검출한 회수를 리턴합니다. |
String [] |
getMemoryManagerNames ()
이 메모리프르를 관리하고 있는 MS-DOS메모리 관리 프로그램 이름을 리턴합니다. |
String |
getName ()
이 메모리프르를 나타내는 이름을 리턴합니다. |
MemoryUsage |
getPeakUsage ()
Java 가상 머신이 시작되고 나서, 또는 피크가 리셋 되고 나서의, 이 메모리프르의 피크메모리 사용량을 리턴합니다. |
MemoryType |
getType ()
이 메모리프르의 형태를 리턴합니다. |
MemoryUsage |
getUsage ()
이 메모리프르의 메모리 사용량의 평가치를 리턴합니다. |
long |
getUsageThreshold ()
이 메모리프르의 사용량의해 귀의치를 바이트 단위로 리턴합니다. |
long |
getUsageThresholdCount ()
메모리 사용량이의해 귀의치를 넘은 회수를 리턴합니다. |
boolean |
isCollectionUsageThresholdExceeded ()
Java 가상 머신이 최선을 다한 마지막 컬렉션의 후에 이 메모리프르의 메모리 사용량이 컬렉션 사용량의해 귀의치에 이른, 또는 넘었는지를 테스트합니다. |
boolean |
isCollectionUsageThresholdSupported ()
이 메모리프르가 컬렉션 사용량의해 귀의치를 지원 할지 어떨지를 테스트합니다. |
boolean |
isUsageThresholdExceeded ()
이 메모리프르의 메모리 사용량이 사용량의해 귀의치에 이른, 또는 넘었는지 어떠했는지를 테스트합니다. |
boolean |
isUsageThresholdSupported ()
이 메모리프르가 사용량의해 귀의치를 지원 할지 어떨지를 테스트합니다. |
boolean |
isValid ()
이 메모리프르가 Java 가상 머신으로 유효한가 어떤가를 테스트합니다. |
void |
resetPeakUsage ()
이 메모리프르의 피크메모리 사용량 통계를 현재의 메모리 사용량에 리셋 합니다. |
void |
setCollectionUsageThreshold (long threhsold)
이 메모리프르의 컬렉션 사용량의해 귀의값이 지정된 threshold 치로 설정합니다. |
void |
setUsageThreshold (long threshold)
이 메모리프르가 사용량의해 귀의치를 지원 하고 있는 경우, 이 메모리프르의의해 귀의값이 지정된 threshold 치로 설정합니다. |
| 메서드의 상세 |
|---|
String getName()
MemoryType getType()
MBeanServer 액세스:
MemoryType
맵형은 String, 값은 MemoryType
이름입니다.
MemoryUsage getUsage()
이 메서드는 이 메모리프르의 현재의 메모리 사용량의 best effort의 평가를 실시하도록 Java 가상 머신에 요구합니다. 일부의 메모리프르에서는 이 메서드는 평가치의 판정에 얼마인가의 계산을 필요로 하는 부하의 큰 조작이 될 가능성이 있습니다. 구현에서는 이러한 케이스를 문서화할 필요가 있습니다.
이 메서드는 시스템메모리 사용량의 감시와 메모리 부족 조건의 검출에 사용하기 위해서 설계되고 있습니다.
MBeanServer 액세스:
MemoryUsage
맵형은, MemoryUsage 로 지정된 속성을 가지는 CompositeData 입니다.
MemoryUsage 객체. 이 풀이 무효인 경우는 nullMemoryUsage getPeakUsage()
MBeanServer 액세스:
MemoryUsage
맵형은, MemoryUsage 로 지정된 속성을 가지는 CompositeData 입니다.
MemoryUsage 객체. 이 풀이 무효인 경우는 nullvoid resetPeakUsage()
SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("control")를 가지지 않는 경우boolean isValid()
String [] getMemoryManagerNames()
long getUsageThreshold()
setUsageThreshold 메서드를 사용해 변경할 수 있습니다.
UnsupportedOperationException - 이 메모리프르가 사용량의해 귀의치를 지원
하지 않는 경우isUsageThresholdSupported() void setUsageThreshold(long threshold)
threshold - 바이트 단위의 새롭고 귀의치. 부가 아닌 수치
IllegalArgumentException - threshold가
부의 경우, 또는 이 메모리프르의 사용 가능 메모리량의 최대값
(정의되고 있는 경우)를 넘는 경우
UnsupportedOperationException - 이 메모리프르가 사용량의해 귀의치를 지원
하지 않는 경우
SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("control")를 가지지 않는 경우isUsageThresholdSupported(),
Usage threshold boolean isUsageThresholdExceeded()
UnsupportedOperationException - 이 메모리프르가 사용량의해 귀의치를 지원
하지 않는 경우long getUsageThresholdCount()
UnsupportedOperationException - 이 메모리프르가 사용량의해 귀의치를 지원
하지 않는 경우boolean isUsageThresholdSupported()
long getCollectionUsageThreshold()
setCollectionUsageThreshold 메서드를 사용해 변경할 수 있습니다.
UnsupportedOperationException - 이 메모리프르가 컬렉션 사용량의해 귀의치를 지원
하지 않는 경우isCollectionUsageThresholdSupported() void setCollectionUsageThreshold(long threhsold)
의해 귀의값이 정의 값으로 설정되면, 이 메모리프르로 컬렉션 사용량의해 귀의치의 초과 체크가 유효하게 됩니다.의해 귀의값이 제로로 설정되면, 이 메모리프르로 컬렉션 사용량의해 귀의치의 초과 체크가 무효가 됩니다.
threhsold - 새로운 컬렉션 사용량의해 귀의치 (바이트 단위). 부가 아닌 수치
IllegalArgumentException - threshold가
부의 경우, 또는 이 메모리프르의 사용 가능 메모리량의 최대값
(정의되고 있는 경우)를 넘는 경우
UnsupportedOperationException - 이 메모리프르가 컬렉션 사용량의해 귀의치를 지원
하지 않는 경우
SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("control")를 가지지 않는 경우isCollectionUsageThresholdSupported(),
Collection usage threshold boolean isCollectionUsageThresholdExceeded()
UnsupportedOperationException - 이 메모리프르가 사용량의해 귀의치를 지원
하지 않는 경우long getCollectionUsageThresholdCount()
UnsupportedOperationException - 이 메모리프르가 컬렉션 사용량의해 귀의치를 지원
하지 않는 경우isCollectionUsageThresholdSupported() MemoryUsage getCollectionUsage()
MBeanServer 액세스:
MemoryUsage
맵형은, MemoryUsage 로 지정된 속성을 가지는 CompositeData 입니다.
MemoryUsage . 이 메서드가 지원
되어 있지 않은 경우는 nullboolean isCollectionUsageThresholdSupported()
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 차의 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | 생성자 | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.