java.lang.management
介面 RuntimeMXBean

public interface RuntimeMXBean

Java 虛擬機器的運行時系統的管理介面。

Java 虛擬機器具有此介面的實作類別的單一實例。實作此介面的實例是一個 MXBean，它可以通過調用 ManagementFactory.getRuntimeMXBean() 方法或從平臺 MBeanServer 方法獲得。

在 MBeanServer 中唯一標識運行時系統的 MXBean 的 ObjectName 為：

java.lang:type=Runtime

此介面定義了幾種便捷的方法，可用於存取有關 Java 虛擬機器的系統屬性。

從以下版本開始：

1.5

另請參見：

JMX Specification., 存取 MXBeans 的方式

方法摘要

String	getBootClassPath() 返回由引導類別載入器用於搜尋類別檔案的引導類別路徑。
String	getClassPath() 返回系統類別載入器用於搜尋類別檔案的 Java 類別路徑。
List<String>	getInputArguments() 返回傳遞給 Java 虛擬機器的輸入變數，其中不包括傳遞給 main 方法的變數。
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() 測試 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()

測試 Java 虛擬機器是否支持由引導類別載入器用於搜尋類別檔案的引導類別路徑機制。

返回：

如果 Java 虛擬機器支持此類別路徑機制，則返回 true；否則返回 false。

getBootClassPath

String getBootClassPath()

返回由引導類別載入器用於搜尋類別檔案的引導類別路徑。

引導類別路徑中的多個路徑由平臺（Java 虛擬機器在其上運行）的路徑分隔符字元進行分隔。

Java 虛擬機器實作可能不支持引導類別載入器用於搜尋類別檔案的引導類別路徑機制。isBootClassPathSupported() 方法可用於確定 Java 虛擬機器是否支持此方法。

返回：

引導類別路徑。

拋出：

UnsupportedOperationException - 如果 Java 虛擬機器不支持此操作。

SecurityException - 如果存在安全管理器，且調用方不具有 ManagementPermission("monitor")。

getInputArguments

List<String> getInputArguments()

返回傳遞給 Java 虛擬機器的輸入變數，其中不包括傳遞給 main 方法的變數。如果沒有傳遞給 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 的映射型別為每行具有兩個項的 TabularData，如下所示：

項名稱	項型別
key	String
value	String

返回：

所有系統屬性的名稱和值的映射。

拋出：

SecurityException - 如果安全管理器存在並且其 checkPropertiesAccess 方法不允許存取系統屬性。