モジュール jdk.attach
パッケージ com.sun.tools.attach

クラスVirtualMachineDescriptor


  • public class VirtualMachineDescriptor
    extends Object
    Java仮想マシンを記述します。

    VirtualMachineDescriptorは、Java仮想マシンの記述に使用するコンテナ・クラスです。 これは、ターゲット仮想マシンを識別する識別子と、仮想マシンへの接続を試みるときに使用するAttachProviderへの参照をカプセル化します。 識別子は実装によって異なりますが、通常、各Java仮想マシンがそれぞれ独自のオペレーティング・システム・プロセスで実行される環境ではプロセス識別子(pid)になります。

    VirtualMachineDescriptordisplayNameも持ちます。 表示名は、通常、ツールがユーザーに対して表示する人間が読める形式の文字列です。 たとえば、システムで実行中のJava仮想マシンのリストを示すツールでは、識別子ではなく表示名を使用できます。 VirtualMachineDescriptor表示名なしで作成することもできます。 その場合は、識別子を表示名として使用します。

    VirtualMachineDescriptorインスタンスは、通常はVirtualMachine.list()メソッドを呼び出すことで作成されます。 これは、インストールされているすべてのattach providersで認識されるJava仮想マシンを記述するための、記述子の完全なリストを返します。

    導入されたバージョン:
    1.6
    • コンストラクタの詳細

      • VirtualMachineDescriptor

        public VirtualMachineDescriptor​(AttachProvider provider,
                                        String id,
                                        String displayName)
        指定されたコンポーネントから仮想マシン記述子を作成します。
        パラメータ:
        provider - Java仮想マシンに接続するAttachProvider。
        id - 仮想マシン識別子。
        displayName - 表示名。
        例外:
        NullPointerException - 引数が1つでもnullの場合
      • VirtualMachineDescriptor

        public VirtualMachineDescriptor​(AttachProvider provider,
                                        String id)
        指定されたコンポーネントから仮想マシン記述子を作成します。

        この簡易コンストラクタは、次のように3つの引数のコンストラクタを呼び出すかのように動作します。

        new VirtualMachineDescriptor(provider,  id,  id);

        つまり、表示名が仮想マシン識別子と同じであるような仮想マシン記述子を作成します。

        パラメータ:
        provider - Java仮想マシンに接続するAttachProvider。
        id - 仮想マシン識別子。
        例外:
        NullPointerException - providerまたはidnullの場合。
    • メソッドの詳細

      • provider

        public AttachProvider provider()
        この記述子が参照するAttachProviderを返します。
        戻り値:
        この記述子が参照するAttachProvider
      • id

        public String id()
        この記述子の識別子コンポーネントを返します。
        戻り値:
        この記述子の識別子コンポーネント。
      • displayName

        public String displayName()
        この記述子の表示名コンポーネントを返します。
        戻り値:
        この記述子の表示名コンポーネント。
      • equals

        public boolean equals​(Object ob)
        このVirtualMachineDescriptorが別のオブジェクトと等しいかどうかを判定します。

        指定されたオブジェクトがVirtualMachineDescriptorではない場合、このメソッドはfalseを返します。 2つのVirtualMachineDescriptorsを等しいとみなすためには、両方とも同じプロバイダを参照し、それらのidentifiersが等しい必要があります。

        このメソッドはObject.equalsメソッドの汎用規約を満たします。

        オーバーライド:
        equals 、クラス:  Object
        パラメータ:
        ob - このオブジェクトと比較するオブジェクト
        戻り値:
        指定されたオブジェクトがこのVirtualMachineDescriptorと等しいVirtualMachineDescriptorである場合だけtrue
        関連項目:
        Object.hashCode()HashMap
      • toString

        public String toString()
        VirtualMachineDescriptorの文字列表記を返します。
        オーバーライド:
        toString 、クラス:  Object
        戻り値:
        このオブジェクトの文字列表現