com.sun.management

インタフェース HotSpotDiagnosticMXBean

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

PlatformManagedObject

public interface HotSpotDiagnosticMXBean
extends PlatformManagedObject

HotSpot Virtual Machine 用の診断管理インタフェースです。

診断 MBean は、ほかのプラットフォーム MBean と同様にプラットフォーム MBeanServer に登録されます。

MBeanServer 内で診断 MXBean を一意に識別するための ObjectName は次のとおりです。

com.sun.management:type=HotSpotDiagnostic

.* PlatformManagedObject.getObjectName() メソッドを呼び出すことで取得できます。 入力引数が null の場合は、特に記述がないかぎり、すべてのメソッドが NullPointerException をスローします。

関連項目:

ManagementFactory#getPlatformMXBeans(Class)

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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 オプションを指定された値に設定します。

インタフェース java.lang.management.PlatformManagedObject から継承されたメソッド

getObjectName

メソッドの詳細

dumpHeap

void dumpHeap(String outputFile,
            boolean live)
              throws IOException

hprof ヒープダンプと同じ形式で、ヒープを outputFile ファイルにダンプします。

このメソッドが別のプロセスからリモートで呼び出された場合、ヒープダンプ出力は、ターゲット VM が実行されているマシン上の outputFile というファイルに書き込まれます。outputFile が相対パスの場合は、ターゲット VM が起動した作業ディレクトリの相対パスです。

パラメータ:

outputFile - システムに依存するファイル名

live - true の場合、ライブオブジェクト、つまりほかのオブジェクトから到達可能なオブジェクトのみをダンプする

例外:

IOException - outputFile を作成、オープン、または書き込みできない場合。

UnsupportedOperationException - この操作がサポートされていない場合。

NullPointerException - outputFile が null の場合。

SecurityException - セキュリティーマネージャーが存在し、その SecurityManager.checkWrite(java.lang.String) メソッドが指定されたファイルへの書き込みアクセスを拒否するか、または呼び出し元が ManagmentPermission("control") を持っていない場合。

getDiagnosticOptions

List<VMOption> getDiagnosticOptions()

すべての診断オプション用の VMOption オブジェクトのリストを返します。診断オプションは書き込み可能な VM オプションであり、これは主にトラブルシューティングと診断のために動的に設定できます。

戻り値:

すべての診断オプション用の VMOption オブジェクトのリスト。

getVMOption

VMOption getVMOption(String name)

指定された名前の VM オプションの VMOption オブジェクトを返します。

戻り値:

指定された名前の VM オプションの VMOption オブジェクト。

例外:

NullPointerException - name が 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 - name または value が null の場合。

SecurityException - セキュリティーマネージャーが存在する場合で、呼び出し元が ManagementPermission("control") を持たない場合。