com.sun.management
인터페이스 HotSpotDiagnosticMXBean

public interface HotSpotDiagnosticMXBean

HotSpot Virtual Machine 용의 진단 관리 인터페이스입니다. 진단 MBean 는, 다른 플랫폼 MBean 와 같게 플랫폼 MBeanServer 에 등록됩니다.

MBeanServer 내에서 진단 MXBean 를 일의에 식별하기 위한 ObjectName 는 다음과 같습니다.

com.sun.management:type=HotSpotDiagnostic

메소드의 개요

void	dumpHeap (String outputFile, boolean live) hprof heap 덤프와 같은 형식에서, heap를 outputFile 파일에 덤프 합니다.
List <VMOption >	getDiagnosticOptions () 모든 진단 옵션용의 VMOption 객체의 리스트를 돌려줍니다.
VMOption	getVMOption (String name) 지정된 이름의 VM 옵션의 VMOption 객체를 돌려줍니다.
void	setVMOption (String name, String value) 지정된 이름의 VM 옵션이 지정된 값으로 설정합니다.

메소드의 상세

dumpHeap

void dumpHeap(String  outputFile,
              boolean live)
              throws IOException 

hprof heap 덤프와 같은 형식에서, heap를 outputFile 파일에 덤프 합니다.

이 메소드가 다른 프로세스로부터 원격로 불려 갔을 경우, heap 덤프 출력은, 타겟 VM 가 실행되고 있는 머신상의 outputFile 라고 하는 파일에 기입해집니다. outputFile 가 상대 패스의 경우는, 타겟 VM 가 기동한 작업 디렉토리의 상대 패스입니다.

파라미터:

outputFile - 시스템에 의존하는 파일명

live - true 의 경우, 라이브 객체, 즉 다른 객체로부터 도달 가능한 객체만을 덤프 한다

예외:

IOException - outputFile 를 작성, 오픈, 또는 기입할 수 없는 경우

UnsupportedOperationException - 이 조작이 지원되어 있지 않은 경우

NullPointerException - outputFile 가 null 의 경우

getDiagnosticOptions

List <VMOption > getDiagnosticOptions()

모든 진단 옵션용의 VMOption 객체의 리스트를 돌려줍니다. 진단 옵션은 기입해 가능한 VM 옵션이며, 이것은 주로 트러블 슈팅과 진단을 위해서(때문에) 동적으로 설정할 수 있습니다.

반환값:

모든 진단 옵션용의 VMOption 객체의 리스트

getVMOption

VMOption  getVMOption(String  name)

지정된 이름의 VM 옵션의 VMOption 객체를 돌려줍니다.

반환값:

지정된 이름의 VM 옵션의 VMOption 객체

예외:

NullPointerException - 이름이 null 의 경우

IllegalArgumentException - 지정된 이름의 VM 옵션이 존재하지 않는 경우

setVMOption

void setVMOption(String  name,
                 String  value)

지정된 이름의 VM 옵션이 지정된 값으로 설정합니다. 새로운 값은,getVMOption(java.lang.String) 메소드 또는 getDiagnosticOptions() 메소드에 의해 반환되는 새로운 VMOption 객체에 반영됩니다. 이 메소드는 이 VMOption 객체의 값을 변경하지 않습니다.

파라미터:

name - VM 옵션의 이름

value - 설정되는 VM 옵션의 새로운 값

예외:

IllegalArgumentException - 지정된 이름의 VM 옵션이 존재하지 않는 경우

IllegalArgumentException - 새로운 값이 무효인 경우

IllegalArgumentException - VM 옵션이 기입해 가능하지 않은 경우

NullPointerException - 이름 또는 값이 null 의 경우

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