模块  jdk.attach
软件包  com.sun.tools.attach

Class VirtualMachineDescriptor

  • public class VirtualMachineDescriptorextends Object
    描述Java虚拟机。

    VirtualMachineDescriptor是用于描述Java虚拟机的容器类。 它封装了标识目标虚拟机的标识符，以及尝试连接到虚拟机时应使用的AttachProvider的引用。 标识符与实现有关，但通常是每个Java虚拟机在其自己的操作系统进程中运行的进程标识符（或pid）环境。

    A VirtualMachineDescriptor也有displayName 。 显示名称通常是工具可能向用户显示的人类可读字符串。 例如，显示系统上运行的Java虚拟机列表的工具可能使用显示名称而不是标识符。 可以在没有显示名称的情况下创建VirtualMachineDescriptor 。 在这种情况下，标识符用作显示名称 。

    VirtualMachineDescriptor实例通常通过调用VirtualMachine.list()方法创建。 这将返回完整的描述符列表，以描述所有已安装的Java虚拟机attach providers 。

    从以下版本开始：
    1.6

    • 构造方法详细信息

      • VirtualMachineDescriptor

        public VirtualMachineDescriptor​(AttachProvider provider,                                String id,                                String displayName)
        从给定组件创建虚拟机描述符。
        参数
        provider - 要附加到Java虚拟机的AttachProvider。
        id - 虚拟机标识符。
        displayName - 显示名称。
        异常
        NullPointerException - 如果任何参数是 null

      • VirtualMachineDescriptor

        public VirtualMachineDescriptor​(AttachProvider provider,                                String id)
        从给定组件创建虚拟机描述符。

        这个方便构造函数就好像通过调用三参数构造函数一样工作，如下所示：

        new VirtualMachineDescriptor(provider,  id,  id);

        也就是说，它创建虚拟机描述符，使得显示名称与虚拟机标识符相同。

        参数
        provider - 要附加到Java虚拟机的AttachProvider。
        id - 虚拟机标识符。
        异常
        NullPointerException - 如果 provider或 id是 null 。

    • 方法详细信息

      • provider

        public AttachProvider provider()
        返回此描述符引用的 AttachProvider 。
        结果
        此描述符引用的 AttachProvider 。

      • id

        public String id()
        返回此描述符的标识符组件。
        结果
        此描述符的标识符组件。

      • displayName

        public String displayName()
        返回此描述符的 显示名称组件。
        结果
        此描述符的显示名称组件。

      • equals

        public boolean equals​(Object ob)
        测试此VirtualMachineDescriptor是否与另一个对象相等。

        如果给定对象不是VirtualMachineDescriptor，则此方法返回false 。 要使两个VirtualMachineDescriptors相等，要求它们都引用相同的提供程序，并且它们的identifiers是相同的。

        该方法满足Object.equals方法的一般合同。

        重写：
        equals类 Object
        参数
        ob - 要与此对象进行比较的对象
        结果
        true当且仅当给定对象是等于此VirtualMachineDescriptor的VirtualMachineDescriptor时。
        另请参见：
        Object.hashCode() ， HashMap

      • toString

        public String toString()
        返回 VirtualMachineDescriptor的字符串表示 VirtualMachineDescriptor 。
        重写：
        toString在类 Object
        结果
        a string representation of the object.