Module jdk.attach

软件包 com.sun.tools.attach

Class VirtualMachineDescriptor

java.lang.Object

com.sun.tools.attach.VirtualMachineDescriptor

public class VirtualMachineDescriptor
extends Object

描述一个Java虚拟机。

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

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

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

从以下版本开始：

1.6

构造方法摘要

构造方法

Constructor	描述
VirtualMachineDescriptor(AttachProvider provider, String id)	从给定的组件创建一个虚拟机描述符。
VirtualMachineDescriptor(AttachProvider provider, String id, String displayName)	从给定的组件创建一个虚拟机描述符。

方法摘要

Modifier and Type	方法	描述
String	displayName()	返回此描述符的 显示名称组件。
boolean	equals(Object ob)	测试此VirtualMachineDescriptor与其他对象的相等性。
int	hashCode()	返回此VirtualMachineDescriptor的哈希码值。
String	id()	返回此描述符的标识符组件。
AttachProvider	provider()	返回这个描述符引用的 AttachProvider 。
String	toString()	返回 VirtualMachineDescriptor的字符串表示 VirtualMachineDescriptor 。

Methods inherited from class 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.