Класс AttachProvider

java.lang.Object

com.sun.tools.attach.spi.AttachProvider

public abstract class AttachProvider extends Object

Класс поставщика подключения для подключения к виртуальной машине Java.

Поставщик подключения — это конкретный подкласс этого класса, имеющий конструктор без аргументов и реализующий абстрактные методы, указанные ниже.

Реализация поставщика подключения обычно связана с реализацией виртуальной машины Java, ее версией или даже режимом работы. То есть, конкретная реализация поставщика, как правило, способна подключаться только к определенной реализации или версии виртуальной машины Java. Например, реализация JDK от Oracle поставляется с реализациями поставщиков, которые могут подключаться только к виртуальной машине HotSpot от Oracle. В общем случае, если среда содержит виртуальные машины Java разных версий и от разных поставщиков, то для каждой семьи реализаций или версий будет реализация поставщика подключения.

Поставщик подключения определяется по его name и type. Имя обычно, но не обязательно, соответствует имени поставщика VM. Например, реализация Oracle JDK поставляется с поставщиками подключения, использующими имя пакета "sun" (по историческим причинам). Тип обычно соответствует механизму подключения. Например, реализация, использующая механизм межпроцессного взаимодействия Doors, может использовать тип "doors". Цель имени и типа — идентифицировать поставщиков в средах, где установлено несколько поставщиков.

Реализации AttachProvider загружаются и создаются при первом вызове метода providers. Этот метод пытается загрузить все реализации поставщиков, установленные в платформе.

Все методы в этом классе безопасны для использования несколькими одновременными потоками.

Since:: 1.6

Краткое описание конструкторов

AttachProvider()

Модификатор	Конструктор	Описание
`protected`	Инициализирует новый экземпляр этого класса.

Краткое описание методов

Модификатор и тип	Метод	Описание
`VirtualMachine`	`attachVirtualMachine(VirtualMachineDescriptor vmd)`	Подключается к виртуальной машине Java.
`abstract VirtualMachine`	`attachVirtualMachine(String id)`	Подключается к виртуальной машине Java.
`abstract List<VirtualMachineDescriptor>`	`listVirtualMachines()`	Отображает виртуальные машины Java, известные этому поставщику.
`abstract String`	`name()`	Возвращает имя этого поставщика.
`static List<AttachProvider>`	`providers()`	Возвращает список установленных поставщиков подключения.
`abstract String`	`type()`	Возвращает тип этого поставщика.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

AttachProvider

protected AttachProvider()

Инициализирует новый экземпляр этого класса.

Throws:: SecurityException - Если установлен менеджер безопасности и он запрещает AttachPermission ("createAttachProvider")

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

name

public abstract String name()

Возвращает имя этого поставщика.

Возвращает:: Имя этого поставщика

type

public abstract String type()

Возвращает тип этого поставщика.

Возвращает:: Тип этого поставщика

attachVirtualMachine

public abstract VirtualMachine attachVirtualMachine(String id) throws AttachNotSupportedException, IOException

Подключается к виртуальной машине Java.

Виртуальная машина Java определяется абстрактным идентификатором. Природа этого идентификатора зависит от платформы, но во многих случаях это будет строковое представление идентификатора процесса (или PID).

Этот метод анализирует идентификатор и сопоставляет его с виртуальной машиной Java (в зависимости от реализации). Если поставщик не сможет проанализировать идентификатор, то будет брошено исключение AttachNotSupportedException. После анализа этот метод пытается подключиться к виртуальной машине Java. Если поставщик обнаружит, что идентификатор соответствует несуществующей виртуальной машине Java, или он соответствует виртуальной машине Java, которая не поддерживает механизм подключения, реализованный этим поставщиком, или он обнаружит, что виртуальная машина Java имеет версию, к которой этот поставщик не может подключиться, то будет брошено исключение AttachNotSupportedException.

Параметры:: id - Абстрактный идентификатор, определяющий виртуальную машину Java.
Возвращает:: VirtualMachine, представляющий целевую виртуальную машину.
Throws:: SecurityException - Если установлен менеджер безопасности и он запрещает AttachPermission ("attachVirtualMachine"), или другие разрешения, необходимые реализации.; AttachNotSupportedException - Если идентификатор не может быть проанализирован, или он соответствует несуществующей виртуальной машине Java, или эта виртуальная машина не может быть подключена этим поставщиком.; IOException - Если возникает другая ошибка ввода-вывода; NullPointerException - Если id является null

attachVirtualMachine

public VirtualMachine attachVirtualMachine(VirtualMachineDescriptor vmd) throws AttachNotSupportedException, IOException

Подключается к виртуальной машине Java.

Виртуальная машина Java может быть описана с помощью VirtualMachineDescriptor. Этот метод вызывает метод provider() дескриптора, чтобы проверить, равен ли он этому поставщику. Затем он пытается подключиться к виртуальной машине Java.

Параметры:: vmd - Дескриптор виртуальной машины
Возвращает:: VirtualMachine, представляющий целевую виртуальную машину.
Throws:: SecurityException - Если установлен менеджер безопасности и он запрещает AttachPermission ("attachVirtualMachine"), или другие разрешения, необходимые реализации.; AttachNotSupportedException - Если метод provider() дескриптора возвращает поставщика, который не является этим поставщиком, или он не соответствует виртуальной машине Java, к которой этот поставщик может подключиться.; IOException - Если возникает другая ошибка ввода-вывода; NullPointerException - Если vmd является null

listVirtualMachines

public abstract List<VirtualMachineDescriptor> listVirtualMachines()

Отображает виртуальные машины Java, известные этому поставщику.

Этот метод возвращает список элементов VirtualMachineDescriptor. Каждый VirtualMachineDescriptor описывает виртуальную машину Java, к которой этот поставщик может потенциально подключиться. Нет никакой гарантии, что вызов attachVirtualMachine на каждом дескрипторе в списке приведет к успеху.

Возвращает:: Список дескрипторов виртуальной машины, описывающих виртуальные машины Java, известные этому поставщику (может быть пустым).

providers

public static List<AttachProvider> providers()

Возвращает список установленных поставщиков подключения.

Поставщик AttachProvider устанавливается на платформе, если:

Он установлен в JAR-файле, видимом для загрузчика классов, определяющего тип AttachProvider (обычно, но не обязательно, system class loader).
JAR-файл содержит конфигурацию поставщика, названную com.sun.tools.attach.spi.AttachProvider в каталоге ресурсов META-INF/services.
Файл конфигурации поставщика содержит полное имя класса реализации AttachProvider.

Формат файла конфигурации поставщика — по одному полному имени класса на строке. Пробелы и символы табуляции вокруг каждого имени класса, а также пустые строки игнорируются. Символ комментария — '#' (0x23), и все символы на каждой строке после первого символа комментария игнорируются. Файл должен быть закодирован в UTF-8.

Реализации AttachProvider загружаются и создаются (с помощью конструктора без аргументов) при первом вызове этого метода. Список, возвращаемый первым вызовом этого метода, является списком поставщиков. Последующие вызовы этого метода возвращают список тех же поставщиков. Список является неизменяемым.

Возвращает:: Список установленных поставщиков подключения.

© 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/spi/AttachProvider.html