Класс VirtualMachine

public abstract class VirtualMachine
extends Object

Виртуальная машина Java.

Объект VirtualMachine представляет виртуальную машину Java, к которой присоединена данная виртуальная машина Java. Виртуальная машина Java, к которой она присоединена, иногда называется целевой виртуальной машиной или целевой ВМ. Приложение (как правило, инструмент, например, консоль управления или профайлер) использует VirtualMachine для загрузки агента в целевую ВМ. Например, инструмент профайлера, написанный на языке Java, может присоединиться к работающему приложению и загрузить свой агент профайлера для профилирования работающего приложения.

Объект VirtualMachine получается путем вызова метода attach с идентификатором, который идентифицирует целевую виртуальную машину. Идентификатор зависит от реализации, но обычно представляет собой идентификатор процесса (или PID) в средах, где каждая виртуальная машина Java выполняется в собственном процессе операционной системы. В качестве альтернативы, экземпляр VirtualMachine получается путем вызова метода attach с объектом VirtualMachineDescriptor, полученным из списка описателей виртуальных машин, возвращаемых методом list. После получения ссылки на виртуальную машину, методы loadAgent, loadAgentLibrary и loadAgentPath используются для загрузки агентов в целевую виртуальную машину. Метод loadAgent используется для загрузки агентов, написанных на языке Java и развернутых в JAR file. (См. java.lang.instrument для подробного описания того, как эти агенты загружаются и запускаются). Методы loadAgentLibrary и loadAgentPath используются для загрузки агентов, развернутых либо в динамической библиотеке, либо статически связанных с ВМ и использующих интерфейс инструментов JVM.

В дополнение к загрузке агентов, VirtualMachine предоставляет доступ для чтения к system properties в целевой ВМ. Это может быть полезно в некоторых средах, где свойства, такие как java.home, os.name, или os.arch, используются для построения пути к агенту, который будет загружен в целевую ВМ.

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

// attach to target VM
      VirtualMachine vm = VirtualMachine.attach("2177");

      // start management agent
      Properties props = new Properties();
      props.put("com.sun.management.jmxremote.port", "5000");
      vm.startManagementAgent(props);

      // detach
      vm.detach();

В этом примере мы присоединяемся к виртуальной машине Java, идентифицируемой идентификатором процесса 2177. Затем агент управления JMX запускается в целевом процессе с использованием предоставленных аргументов. Наконец, клиент отсоединяется от целевой ВМ.

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

Конструкторы

VirtualMachine

protected VirtualMachine(AttachProvider provider,
                         String id)

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

Параметры:

provider - Поставщик подключения, создающий этот класс.

id - Абстрактный идентификатор, который идентифицирует виртуальную машину Java.

Исключения:

NullPointerException - Если provider или id имеет значение null.