モジュール jdk.management
パッケージ 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オプションを指定された値に設定します。

    • メソッドの詳細

      • 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

        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")を持たない場合。