Класс VirtualMachineDescriptor

java.lang.Object
- com.sun.tools.attach.VirtualMachineDescriptor

public class VirtualMachineDescriptor
extends Object

Описывает виртуальную машину Java.

Класс VirtualMachineDescriptor является контейнерным классом, используемым для описания виртуальной машины Java. Он инкапсулирует идентификатор, определяющий целевую виртуальную машину, и ссылку на AttachProvider, которая должна использоваться при попытке подключиться к виртуальной машине. Идентификатор зависит от реализации, но обычно это идентификатор процесса (или PID) в средах, где каждая виртуальная машина Java работает в собственном процессе операционной системы.

Класс VirtualMachineDescriptor также имеет displayName. Имя для отображения обычно является строкой, понятной человеку, которую инструмент может отобразить пользователю. Например, инструмент, отображающий список работающих на системе виртуальных машин Java, может использовать имя для отображения вместо идентификатора. Класс VirtualMachineDescriptor может быть создан без имени для отображения. В этом случае идентификатор используется как имя для отображения.

Экземпляры класса VirtualMachineDescriptor обычно создаются вызовом метода VirtualMachine.list(). Это возвращает полный список описателей для описания всех виртуальных машин Java, известных всем установленным attach providers.

Since:: 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`.

Методы, объявленные в классе java.lang.Object

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

Конструкторы

VirtualMachineDescriptor

public VirtualMachineDescriptor(AttachProvider provider,
                                String id,
                                String displayName)

Создает описатель виртуальной машины из заданных компонентов.

Parameters:: provider - The AttachProvider to attach to the Java virtual machine.; id - The virtual machine identifier.; displayName - The display name.
Throws:: NullPointerException - Если какой-либо из аргументов null

VirtualMachineDescriptor

public VirtualMachineDescriptor(AttachProvider provider,
                                String id)

Создает описатель виртуальной машины из заданных компонентов.

Этот конструктор-утилита работает так, как если бы он вызывал конструктор с тремя аргументами следующим образом:

new VirtualMachineDescriptor(provider,  id,  id);

То есть он создает описатель виртуальной машины таким образом, что имя для отображения совпадает с идентификатором виртуальной машины.

Parameters:: provider - The AttachProvider to attach to the Java virtual machine.; id - The virtual machine identifier.
Throws:: NullPointerException - Если provider или id null.

Методы

provider

public AttachProvider provider()

Возвращает AttachProvider, на которую ссылается этот описатель.

Returns:: The AttachProvider that this descriptor references.

id

public String id()

Возвращает компонент идентификатора этого описателя.

Returns:: The identifier component of this descriptor.

displayName

public String displayName()

Возвращает компонент имя для отображения этого описателя.

Returns:: The display name component of this descriptor.

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого VirtualMachineDescriptor. Хэш-код основан на компонентах описателя и удовлетворяет общему контракту метода Object.hashCode.

Overrides:: hashCode in class Object
Returns:: A hash-code value for this descriptor.
See Also:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object ob)

Проверяет этот VirtualMachineDescriptor на равенство с другим объектом.

Если данный объект не является VirtualMachineDescriptor, то этот метод возвращает false. Для того чтобы два VirtualMachineDescriptor считались равными, необходимо, чтобы они оба ссылались на один и тот же провайдер, и их identifiers были равны.

Этот метод удовлетворяет общему контракту метода Object.equals.

Overrides:: equals in class Object
Parameters:: ob - The object to which this object is to be compared
Returns:: true если и только если данный объект является VirtualMachineDescriptor, равным этому VirtualMachineDescriptor.
See Also:: Object.hashCode(), HashMap

toString

public String toString()

Возвращает строковое представление VirtualMachineDescriptor.

Overrides:: toString in class Object
Returns:: a string representation of the object.