Класс VirtualMachineDescriptor

java.lang.Object

com.sun.tools.attach.VirtualMachineDescriptor

public class VirtualMachineDescriptor extends Object

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

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

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

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

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()`	Возвращает строковое представление описателя.

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

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

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

VirtualMachineDescriptor

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

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

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

VirtualMachineDescriptor

public VirtualMachineDescriptor(AttachProvider provider, String id)

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

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

new VirtualMachineDescriptor(provider, id, id);

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

Параметры:: provider - The AttachProvider to attach to the Java virtual machine.; id - The virtual machine identifier.
Исключения:: 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.

Overrides:

hashCode в классе Object

Возвращает:

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

См. также:

equals

public boolean equals(Object ob)

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

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

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

Overrides:

equals в классе Object

Параметры:

ob - Объект, с которым должен быть сравнен этот объект

Возвращает:

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

См. также:

toString

public String toString()

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

Overrides:: 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://download.java.net/java/early_access/jdk24/docs/api/jdk.attach/com/sun/tools/attach/VirtualMachineDescriptor.html