- すべてのスーパー・インタフェース:
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ファイルにダンプします。default voiddumpThreads(String outputFile, HotSpotDiagnosticMXBean.ThreadDumpFormat format) 指定されたファイルに指定された形式でスレッド・ダンプを生成します。すべての診断オプションについて、VMOptionオブジェクトのリストを返します。getVMOption(String name) 指定された名前のVMオプションに対するVMOptionオブジェクトを返します。voidsetVMOption(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がliveオブジェクトのみ(他のオブジェクトからアクセス可能なオブジェクト)をダンプした場合- 例外:
IOException-outputFileがすでに存在する場合は、作成、オープン、または書き込むことはできません。UnsupportedOperationException- この操作がサポートされていない場合。IllegalArgumentException-outputFileが".hprof"サフィクスで終わらない場合。NullPointerException-outputFileがnullの場合。SecurityException- セキュリティ・マネージャが存在し、そのSecurityManager.checkWrite(java.lang.String)メソッドが指定されたファイルへの書込みアクセスを拒否するか、または呼出し元がManagmentPermission("control")を持っていない場合。
-
getDiagnosticOptions
-
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- 名前または値がnullの場合。SecurityException- セキュリティ・マネージャが存在する場合で、呼出し元がManagementPermission("control")を持たない場合。
-
dumpThreads
default void dumpThreads(String outputFile, HotSpotDiagnosticMXBean.ThreadDumpFormat format) throws IOException 指定されたファイルに指定された形式でスレッド・ダンプを生成します。outputFileパラメータは、存在しないファイルへの絶対パスである必要があります。スレッド・ダンプには、すべてのプラットフォーム・スレッドの出力が含まれます。 一部またはすべての仮想スレッドの出力が含まれる場合があります。
- APIのノート:
- 現在の作業ディレクトリが異なるツールまたはプログラムからMXBeanにリモートでアクセスできるため、出力ファイルは絶対パスである必要があります。
- 実装要件:
- デフォルト実装は
UnsupportedOperationExceptionをスローします。 - パラメータ:
outputFile- 作成するファイルへのパスformat- 使用する形式- 例外:
IllegalArgumentException- ファイル・パスが絶対パスでない場合IOException- ファイルがすでに存在するか、ファイルに書き込むI/O例外がスローされた場合NullPointerException- いずれかのパラメータがnullの場合SecurityException- セキュリティ・マネージャが設定されていて、そのSecurityManager.checkWrite(java.lang.String)メソッドがファイルへの書込みアクセスを拒否するか、ManagementPermission("control")が拒否された場合UnsupportedOperationException- この操作がサポートされていない場合- 導入されたバージョン:
- 21
-