モジュール jdk.management

パッケージ com.sun.management

インタフェースHotSpotDiagnosticMXBean

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

PlatformManagedObject

public interface HotSpotDiagnosticMXBean extends PlatformManagedObject

HotSpot仮想マシン用の診断管理インタフェースです。

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

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

com.sun.management:type=HotSpotDiagnostic

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

関連項目:

• ManagementFactory.getPlatformMXBeans(Class)

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	インタフェース	説明
static enum	HotSpotDiagnosticMXBean.ThreadDumpFormatPREVIEW	Preview. スレッドのダンプ形式。

メソッドのサマリー

修飾子と型	メソッド	説明
void	dumpHeap(String outputFile, boolean live)	ヒープをhprofヒープ・ダンプと同じ形式でoutputFileファイルにダンプします。
default void	dumpThreads(String outputFile, HotSpotDiagnosticMXBean.ThreadDumpFormatPREVIEW format)	Preview. 指定されたファイルに指定された形式でスレッド・ダンプを生成します。
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がliveオブジェクトのみ(他のオブジェクトからアクセス可能なオブジェクト)をダンプした場合

例外:

IOException - outputFileがすでに存在する場合は、作成、オープン、または書き込むことはできません。

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

IllegalArgumentException - outputFileが".hprof"サフィクスで終わらない場合。

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 - 名前または値がnullの場合。

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

dumpThreads

default void dumpThreads(String outputFile, HotSpotDiagnosticMXBean.ThreadDumpFormatPREVIEW format) throws IOException

dumpThreadsは、Javaプラットフォームのリフレクティブ・プレビューAPIです。

プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。

指定されたファイルに指定された形式でスレッド・ダンプを生成します。 outputFileパラメータは、存在しないファイルへの絶対パスである必要があります。

スレッド・ダンプには、すべてのプラットフォーム・スレッドの出力が含まれます。 一部またはすべての仮想スレッドの出力が含まれる場合があります。

APIのノート:

現在の作業ディレクトリが異なるツールまたはプログラムからMXBeanにリモートでアクセスできるため、出力ファイルは絶対パスである必要があります。

実装要件:

デフォルト実装はUnsupportedOperationExceptionをスローします。

パラメータ:

outputFile - 作成するファイルへのパス

format - 使用する形式

例外:

IllegalArgumentException - ファイル・パスが絶対パスでない場合

IOException - ファイルがすでに存在するか、ファイルに書き込むI/O例外がスローされた場合

NullPointerException - いずれかのパラメータがnullの場合

SecurityException - セキュリティ・マネージャが設定されていて、そのSecurityManager.checkWrite(java.lang.String)メソッドがファイルへの書込みアクセスを拒否するか、ManagementPermission("control")が拒否された場合

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

導入されたバージョン:

19