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 스펙. , MXBean 에 액세스 하는 방법

메소드의 개요

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 가상 머신에의 입력 인수가 없는 경우, 이 메소드는 빈 상태(empty)의 리스트를 돌려줍니다.

일부의 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 메소드가 이 시스템 프로퍼티에의 액세스를 허가하지 않는 경우