Класс 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, 2023, 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/21/docs/api/jdk.attach/com/sun/tools/attach/VirtualMachineDescriptor.html