Класс 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.

Начиная с:: 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`.

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

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

Подробное описание конструкторов

VirtualMachineDescriptor

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

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

Параметры:: provider — AttachProvider, к которому следует подключиться для доступа к виртуальной машине Java.; id — идентификатор виртуальной машины.; displayName — отображаемое имя.
Выбрасывает:: NullPointerException — если любой из аргументов null

VirtualMachineDescriptor

public VirtualMachineDescriptor(AttachProvider provider, String id)

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

Этот вспомогательный конструктор работает так, как если бы был вызван трехаргументный конструктор следующим образом:

new VirtualMachineDescriptor(provider, id, id);

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

Параметры:: provider — AttachProvider, к которому следует подключиться для доступа к виртуальной машине Java.; 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

Возвращает:

Значение хеш-кода для этого дескриптора.

См. также:

equals

public boolean equals(Object ob)

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

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

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

Переопределяет:

equals в классе Object

Параметры:

ob — объект, с которым сравнивается этот объект

Возвращает:

true тогда и только тогда, когда переданный объект является VirtualMachineDescriptor, равным этому VirtualMachineDescriptor.

См. также:

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта

© 1993, 2025, 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/25/docs/api/jdk.attach/com/sun/tools/attach/VirtualMachineDescriptor.html