模块 jdk.attach

软件包 com.sun.tools.attach

Class VirtualMachineDescriptor

java.lang.Object

com.sun.tools.attach.VirtualMachineDescriptor

public class VirtualMachineDescriptor
extends Object

描述Java虚拟机。

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

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

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

从以下版本开始：

1.6

构造方法摘要

构造方法

构造器	描述
VirtualMachineDescriptor(AttachProvider provider, String id)	从给定组件创建虚拟机描述符。
VirtualMachineDescriptor(AttachProvider provider, String id, String displayName)	从给定组件创建虚拟机描述符。

方法摘要

变量和类型	方法	描述
String	displayName()	返回此描述符的 显示名称组件。
boolean	equals(Object ob)	测试此VirtualMachineDescriptor是否与另一个对象相等。
int	hashCode()	返回此VirtualMachineDescriptor的哈希码值。
String	id()	返回此描述符的标识符组件。
AttachProvider	provider()	返回此描述符引用的 AttachProvider 。
String	toString()	返回 VirtualMachineDescriptor的字符串表示 VirtualMachineDescriptor 。

声明方法的类 java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造方法详细信息

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()

返回此描述符的 显示名称组件。

结果

此描述符的显示名称组件。

hashCode

public int hashCode()

返回此VirtualMachineDescriptor的哈希码值。 哈希码基于描述符的组件，并且满足Object.hashCode方法的一般契约。

重写：

hashCode类 Object

结果

此描述符的哈希码值。

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

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.