モジュール java.management

パッケージ java.lang.management

インタフェースRuntimeMXBean

すべてのスーパー・インタフェース:

PlatformManagedObject

public interface RuntimeMXBean extends PlatformManagedObject

Java仮想マシンの実行時システムの管理インタフェースです。

Java仮想マシンは、このインタフェースの実装クラスの単一インスタンスを持ちます。 このインタフェースを実装するこのインスタンスは、ManagementFactory.getRuntimeMXBean()メソッドをコールするか、platform MBeanServerメソッドから取得できるMXBeanです。

MBeanServer内のランタイム・システムのMXBeanを一意に識別するためのObjectNameは、次のとおりです:

java.lang:type=Runtime

これを取得するには、PlatformManagedObject.getObjectName()メソッドを呼び出します。

このインタフェースは、Java仮想マシンのシステム・プロパティにアクセスする複数の簡易メソッドを定義します。

導入されたバージョン:

1.5

関連項目:

• ManagementFactory.getPlatformMXBeans(Class)
• JMX仕様
• MXBeanにアクセスする方法

メソッドのサマリー

修飾子と型	メソッド	説明
String	getBootClassPath()	ブートストラップ・クラス・ローダーがクラス・ファイルの検索に使用するブート・クラスパスを返します。
String	getClassPath()	クラス・ファイルを検索するためにシステムのクラス・ローダーにより使用されるJavaクラス・パスを返します。
List<String>	getInputArguments()	mainメソッドへの引数を含まない、Java仮想マシンに渡される入力引数を返します。
String	getLibraryPath()	Javaライブラリ・パスを返します。
String	getManagementSpecVersion()	実行しているJava仮想マシンにより実装された管理インタフェースの仕様のバージョンを返します。
String	getName()	実行しているJava仮想マシンを表す名前を返します。
default long	getPid()	実行中のJava仮想マシンを表す「プロセスID」を返します。
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仮想マシンがサポートするかどうかをテストします。

インタフェースjava.lang.management.PlatformManagedObjectで宣言されたメソッド

getObjectName

メソッドの詳細

getPid

default long getPid()

実行中のJava仮想マシンを表す「プロセスID」を返します。

実装要件:

デフォルトの実装では、「現在のプロセス」のprocess IDが返されます。

戻り値:

実行中のJava仮想マシンを表すプロセスID。

導入されたバージョン:

10

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()

mainメソッドへの引数を含まない、Java仮想マシンに渡される入力引数を返します。 Java仮想マシンへの入力引数がない場合、このメソッドは空のリストを返します。

一部のJava仮想マシンの実装では、複数の異なるソースから入力引数を取得できます。入力引数には、「java」コマンド、環境変数、および構成ファイルなど、Java仮想マシンを起動するアプリケーションから渡される引数があります。

一般に、「java」コマンドへのすべてのコマンド行オプションがJava仮想マシンに渡されるわけではありません。 つまり、返された入力引数にすべてのコマンド行オプションが含まれるわけではありません。

MBeanServerアクセス:
List<String>のマップされたタイプは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<String,String>のマップ型は、次のように各行に2つの項目を持つTabularDataです。

各項目の名前および型

項目名	項目タイプ
key	String
value	String

戻り値:

すべてのシステム・プロパティの名前と値のマップ

例外:

SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckPropertiesAccessメソッドがシステム・プロパティへのアクセスを許可しない場合。