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 ヒープダンプと同じ形式で、ヒープを 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 ヒープダンプと同じ形式で、ヒープを outputFile ファイルにダンプします。

このメソッドが別のプロセスからリモートで呼び出された場合、ヒープダンプ出力は、ターゲット 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") を持たない場合