java.lang.management
인터페이스 RuntimeMXBean

public interface RuntimeMXBean

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

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

MXBeanServer 내에서 실행시 시스템의 MXBean를 일의에 식별하기 위한 ObjectName는 이하대로입니다.

java.lang:type=Runtime

이 인터페이스는 Java 가상 머신의 시스템 프로퍼티에 액세스 하는 복수의 간이 메서드를 정의합니다.

도입된 버전 :

1.5

관련 항목:

JMX Specification, Ways to Access MXBeans

메서드 개요

String	getBootClassPath () bootstrap 클래스 로더가 클래스 파일의 검색에 사용하는 부트 클래스 패스를 리턴합니다.
String	getClassPath () 클래스 파일을 검색하기 위해서 시스템의 클래스 로더에 의해 사용되는 Java 클래스 패스를 리턴합니다.
List <String >	getInputArguments () main 메서드에의 인수를 가지지 않는 Java 가상 머신에게 건네지는 입력 인수를 리턴합니다.
String	getLibraryPath () Java 라이브러리 패스를 리턴합니다.
String	getManagementSpecVersion () 실행하고 있는 Java 가상 머신에 의해 구현된 관리 인터페이스의 사양의 버전을 리턴합니다.
String	getName () 실행하고 있는 Java 가상 머신을 나타내는 이름을 리턴합니다.
String	getSpecName () Java 가상 머신 사양의 이름을 리턴합니다.
String	getSpecVendor () Java 가상 머신 사양의 벤더를 리턴합니다.
String	getSpecVersion () Java 가상 머신 사양의 버전을 리턴합니다.
long	getStartTime () Java 가상 머신의 시작 시간 (밀리 세컨드 단위)을 리턴합니다.
Map <String, String >	getSystemProperties () 모든 시스템 프로퍼티의 이름과 값의 맵을 리턴합니다.
long	getUptime () Java 가상 머신의 종료시간 (밀리 세컨드 단위)을 리턴합니다.
String	getVmName () Java 가상 머신의 구현의 이름을 리턴합니다.
String	getVmVendor () Java 가상 머신 구현의 벤더를 리턴합니다.
String	getVmVersion () Java 가상 머신 구현의 버전을 리턴합니다.
boolean	isBootClassPathSupported () bootstrap 클래스 로더가 클래스 파일의 검색에 사용하는 부트 클래스 패스 메카니즘을 Java 가상 머신이 지원 할지 어떨지를 테스트합니다.

메서드의 상세

getName

String  getName()

실행하고 있는 Java 가상 머신을 나타내는 이름을 리턴합니다. 리턴된 이름은 임의의 캐릭터 라인으로 할 수 있습니다 . 또, Java 가상 머신의 구현에서는 리턴된 이름 캐릭터 라인에 플랫폼 고유의 도움이 되는 정보를 짜넣도록 선택할 수 있습니다. 실행하고 있는 각 가상 머신에는 다른 이름을 붙일 수가 있습니다.

반환값:

실행하고 있는 Java 가상 머신을 나타내는 이름

getVmName

String  getVmName()

Java 가상 머신의 구현의 이름을 리턴합니다. 이 메서드는 System.getProperty("java.vm.name") 와 동등합니다.

반환값:

Java 가상 머신의 구현명

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getVmVendor

String  getVmVendor()

Java 가상 머신 구현의 벤더를 리턴합니다. 이 메서드는 System.getProperty("java.vm.vendor") 와 동등합니다.

반환값:

Java 가상 머신 구현의 벤더

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getVmVersion

String  getVmVersion()

Java 가상 머신 구현의 버전을 리턴합니다. 이 메서드는 System.getProperty("java.vm.version") 와 동등합니다.

반환값:

Java 가상 머신 구현의 버전

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getSpecName

String  getSpecName()

Java 가상 머신 사양의 이름을 리턴합니다. 이 메서드는 System.getProperty("java.vm.specification.name") 와 동등합니다.

반환값:

Java 가상 머신의 사양명

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getSpecVendor

String  getSpecVendor()

Java 가상 머신 사양의 벤더를 리턴합니다. 이 메서드는 System.getProperty("java.vm.specification.vendor") 와 동등합니다.

반환값:

Java 가상 머신 사양의 벤더

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getSpecVersion

String  getSpecVersion()

Java 가상 머신 사양의 버전을 리턴합니다. 이 메서드는 System.getProperty("java.vm.specification.version") 와 동등합니다.

반환값:

Java 가상 머신 사양의 버전

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getManagementSpecVersion

String  getManagementSpecVersion()

실행하고 있는 Java 가상 머신에 의해 구현된 관리 인터페이스의 사양의 버전을 리턴합니다.

반환값:

실행하고 있는 Java 가상 머신에 의해 구현된 관리 인터페이스의 사양의 버전

getClassPath

String  getClassPath()

클래스 파일을 검색하기 위해서 시스템의 클래스 로더에 의해 사용되는 Java 클래스 패스를 리턴합니다. 이 메서드는 System.getProperty("java.class.path") 와 동등합니다.

감시되고 있는 Java 가상 머신의 플랫폼의 패스 단락 문자로 단락지어진, Java 클래스 패스의 복수의 패스

반환값:

Java 클래스 패스

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getLibraryPath

String  getLibraryPath()

Java 라이브러리 패스를 리턴합니다. 이 메서드는 System.getProperty("java.library.path") 와 동등합니다.

감시되고 있는 Java 가상 머신의 플랫폼의 패스 단락 문자로 단락지어진, Java 라이브러리 패스의 복수의 패스입니다.

반환값:

Java 라이브러리 패스

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

isBootClassPathSupported

boolean isBootClassPathSupported()

bootstrap 클래스 로더가 클래스 파일의 검색에 사용하는 부트 클래스 패스 메카니즘을 Java 가상 머신이 지원 할지 어떨지를 테스트합니다.

반환값:

Java 가상 머신이 클래스 패스 메카니즘을 지원하는인 경우는 true, 그렇지 않은 경우는 false

getBootClassPath

String  getBootClassPath()

bootstrap 클래스 로더가 클래스 파일의 검색에 사용하는 부트 클래스 패스를 리턴합니다.

Java 가상 머신이 실행되고 있는 플랫폼의 패스 단락 문자로 단락지어진 부트 클래스 패스의 복수의 패스입니다.

Java 가상 머신의 구현은 bootstrap 클래스 로더가 클래스 파일의 검색에 사용하는 부트 클래스 패스 메카니즘을 지원 하지 않는 경우가 있습니다. isBootClassPathSupported() 메서드를 사용해, Java 가상 머신이 이 메서드를 지원 할지 어떨지를 판정할 수 있습니다.

반환값:

부트 클래스 패스

예외:

UnsupportedOperationException - Java 가상 머신이 이 조작을 지원 하고 있지 않는 경우

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

getInputArguments

List <String > getInputArguments()

main 메서드에의 인수를 가지지 않는 Java 가상 머신에게 건네지는 입력 인수를 리턴합니다. Java 가상 머신에의 입력 인수가 없는 경우, 이 메서드는 비어있는 리스트를 리턴합니다.

일부의 Java 가상 머신의 구현에서는 복수가 다른 소스로부터 입력 인수를 취득할 수 있습니다. 입력 인수에는 「java」커멘드, 환경 변수 및 구성 파일 등, Java 가상 머신을 시작하는 어플리케이션으로부터 건네받는 인수가 있습니다.

일반적으로 「java」커멘드에의 모든 커멘드 라인 옵션이 Java 가상 머신에게 건네지는 것은 아닙니다. 즉, 리턴된 입력 인수에 모든 커멘드 라인 옵션이 포함되는 것은 아닙니다.

MBeanServer 액세스:
List 맵형은, String[] 입니다.

반환값:

String 객체의 리스트. 배열의 각 요소는 Java 가상 머신에게 건네지는 인수

예외:

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

getUptime

long getUptime()

Java 가상 머신의 종료시간 (밀리 세컨드 단위)을 리턴합니다.

반환값:

Java 가상 머신의 종료시간 (밀리 세컨드 단위)

getStartTime

long getStartTime()

Java 가상 머신의 시작 시간 (밀리 세컨드 단위)을 리턴합니다. 이 메서드는 Java 가상 머신이 시작했을 때의 대략의 시간을 리턴합니다.

반환값:

Java 가상 머신의 시작 시간 (밀리 세컨드 단위)

getSystemProperties

Map <String,
String > getSystemProperties()

모든 시스템 프로퍼티의 이름과 값의 맵을 리턴합니다. 이 메서드는 System.getProperties()를 호출해, 모든 시스템 프로퍼티를 취득합니다. 이름 또는 값이 String가 아닌 프로퍼티는 생략 됩니다.

MBeanServer 액세스:
Map 맵형은 다음과 같이 각 행에 2개의 항목을 가지는 TabularData 입니다.

항목명	항목의 형태
key	String
value	String

반환값:

모든 시스템 프로퍼티의 이름과 값의 맵

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우