Класс 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 - If any of the arguments are 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 - If provider or id is 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:

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 if, and only if, the given object is a VirtualMachineDescriptor that is equal to this VirtualMachineDescriptor.

See Also:

toString

public String toString()

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

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

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/jdk.attach/com/sun/tools/attach/VirtualMachineDescriptor.html