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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или прерывания, либо истечения заданного промежутка реального времени.

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

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.