- すべてのスーパー・インタフェース:
PlatformManagedObject
public interface HotSpotDiagnosticMXBean extends PlatformManagedObject
HotSpot仮想マシン用の診断管理インタフェースです。
診断MBeanは、ほかのプラットフォームMBeanと同様にプラットフォームMBeanServerに登録されます。
MBeanServer内で診断MXBeanを一意に識別するためのObjectName
は次のとおりです。
com.sun.management:type=HotSpotDiagnostic
.* PlatformManagedObject.getObjectName()
メソッドを呼び出すことで取得できます。 入力引数がnull
の場合は、特に記述がないかぎり、すべてのメソッドがNullPointerException
をスローします。 -
メソッドのサマリー
修飾子と型メソッド説明void
hprofヒープ・ダンプと同じ形式で、ヒープをoutputFile
ファイルにダンプします。すべての診断オプション用の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
- この操作がサポートされていない場合。IllegalArgumentException
-outputFile
が".hprof"サフィクスで終わらない場合。NullPointerException
-outputFile
がnull
の場合。SecurityException
- セキュリティ・マネージャが存在し、そのSecurityManager.checkWrite(java.lang.String)
メソッドが指定されたファイルへの書込みアクセスを拒否するか、または呼出し元がManagmentPermission("control")を持っていない場合。
-
getDiagnosticOptions
すべての診断オプション用のVMOption
オブジェクトのリストを返します。 診断オプションは書込み可能な
VMオプションであり、これは主にトラブルシューティングと診断のために動的に設定できます。- 戻り値:
- すべての診断オプション用の
VMOption
オブジェクトのリスト。
-
getVMOption
指定された名前のVMオプションのVMOption
オブジェクトを返します。- 戻り値:
- 指定された名前のVMオプションの
VMOption
オブジェクト。 - 例外:
NullPointerException
- nameがnull
の場合。IllegalArgumentException
- 指定された名前のVMオプションが存在しない場合。
-
setVMOption
指定された名前のVMオプションを指定された値に設定します。 新しい値は、getVMOption(java.lang.String)
メソッドまたはgetDiagnosticOptions()
メソッドによって返される新しいVMOption
オブジェクトに反映されます。 このメソッドはこのVMOption
オブジェクトの値を変更しません。- パラメータ:
name
- VMオプションの名前value
- 設定されるVMオプションの新しい値- 例外:
IllegalArgumentException
- 指定された名前のVMオプションが存在しない場合。IllegalArgumentException
- 新しい値が無効な場合。IllegalArgumentException
- VMオプションが書き込み可能でない場合。NullPointerException
- nameまたはvalueがnull
の場合。SecurityException
- セキュリティ・マネージャが存在する場合で、呼出し元がManagementPermission("control")を持たない場合。
-