Класс VirtualMachine

protected VirtualMachine(AttachProvider provider, String id)

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

public static List<VirtualMachineDescriptor> list()

Возвращает список виртуальных машин Java.

Этот метод возвращает список элементов Java VirtualMachineDescriptor. Список представляет собой объединение списков дескрипторов виртуальных машин, полученных вызовом метода listVirtualMachines всех установленных attach providers. Если ни одному поставщику не известны виртуальные машины Java, возвращается пустой список.

public static VirtualMachine attach(String id) throws AttachNotSupportedException, IOException

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

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

public static VirtualMachine attach(VirtualMachineDescriptor vmd) throws AttachNotSupportedException, IOException

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

Сначала этот метод вызывает метод provider() заданного дескриптора виртуальной машины, чтобы получить поставщика подключения. Затем он вызывает метод attachVirtualMachine этого поставщика для подключения к целевой виртуальной машине.

public abstract void detach() throws IOException

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

После отключения от виртуальной машины любая последующая попытка выполнить операции с этой виртуальной машиной приведет к выбрасыванию IOException. Если во время вызова этого метода выполняется операция (например, loadAgent), ее поведение зависит от реализации. Иными словами, реализация определяет, завершится ли операция или выбросит IOException.

Если подключение к виртуальной машине уже разорвано, вызов этого метода не оказывает никакого действия.

public final AttachProvider provider()

Возвращает поставщика, создавшего эту виртуальную машину.

public final String id()

Возвращает идентификатор этой виртуальной машины Java.

public abstract void loadAgentLibrary(String agentLibrary, String options) throws AgentLoadException, AgentInitializationException, IOException

Загружает библиотеку агента.

Клиент JVM TI называется агентом. Он разрабатывается на языке программирования низкого уровня. Развертывание агента JVM TI зависит от платформы, но обычно он представляет собой эквивалент динамической библиотеки для данной платформы. В качестве альтернативы агент может быть статически связан с виртуальной машиной. Этот метод загружает заданную библиотеку агента в целевую виртуальную машину (если она еще не загружена и не связана с виртуальной машиной статически). Затем он вызывает в целевой виртуальной машине функцию Agent_OnAttach или, для статически связанного агента с именем «L», функцию Agent_OnAttach_L, как указано в спецификации интерфейса JVM Tools. Обратите внимание, что функция Agent_OnAttach[_L] вызывается, даже если библиотека агента была загружена до вызова этого метода.

В качестве библиотеки агента указывается ее имя. Оно интерпретируется в целевой виртуальной машине способом, зависящим от реализации. Обычно реализация преобразует имя библиотеки в имя файла, специфичное для операционной системы. Например, в UNIX-системах имя L может преобразовываться в libL.so, а поиск выполняться по пути, заданному переменной среды LD_LIBRARY_PATH. Если агент с именем «L» статически связан с виртуальной машиной, она должна экспортировать функцию с именем Agent_OnAttach_L.

Если функция Agent_OnAttach[_L] в библиотеке агента возвращает ошибку, выбрасывается AgentInitializationException. Возвращаемое значение Agent_OnAttach[_L] можно получить, вызвав метод returnValue у исключения.

public void loadAgentLibrary(String agentLibrary) throws AgentLoadException, AgentInitializationException, IOException

Загружает библиотеку агента.

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

loadAgentLibrary(agentLibrary, null);

public abstract void loadAgentPath(String agentPath, String options) throws AgentLoadException, AgentInitializationException, IOException

Загружает библиотеку нативного агента по полному пути.

Клиент JVM TI называется агентом. Он разрабатывается на языке программирования низкого уровня. Развертывание агента JVM TI зависит от платформы, но обычно он представляет собой эквивалент динамической библиотеки для данной платформы. В качестве альтернативы нативная библиотека, заданная параметром agentPath, может быть статически связана с виртуальной машиной. Преобразование параметра agentPath в имя статически связанной библиотеки выполняется в виртуальной машине способом, зависящим от платформы. Например, в UNIX параметр agentPath со значением /a/b/libL.so задает библиотеку «L». Дополнительные сведения см. в спецификации JVM TI. Этот метод загружает заданную библиотеку агента в целевую виртуальную машину (если она еще не загружена и не связана с виртуальной машиной статически). Затем он вызывает в целевой виртуальной машине функцию Agent_OnAttach или, для статически связанного агента с именем «L», функцию Agent_OnAttach_L, как указано в спецификации интерфейса JVM Tools. Обратите внимание, что функция Agent_OnAttach[_L] вызывается, даже если библиотека агента была загружена до вызова этого метода.

В качестве библиотеки агента указывается абсолютный путь, по которому ее следует загрузить. В отличие от loadAgentLibrary, имя библиотеки не преобразуется в целевой виртуальной машине.

Если функция Agent_OnAttach[_L] в библиотеке агента возвращает ошибку, выбрасывается AgentInitializationException. Возвращаемое значение Agent_OnAttach[_L] можно получить, вызвав метод returnValue у исключения.

public void loadAgentPath(String agentPath) throws AgentLoadException, AgentInitializationException, IOException

Загружает библиотеку нативного агента по полному пути.

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

loadAgentPath(agentLibrary, null);

public abstract void loadAgent(String agent, String options) throws AgentLoadException, AgentInitializationException, IOException

Загружает агента.

В качестве агента этому методу передается имя пути к JAR-файлу в файловой системе целевой виртуальной машины. Этот путь передается целевой виртуальной машине, где он интерпретируется. Целевая виртуальная машина пытается запустить агента в соответствии со спецификацией java.lang.instrument. Иными словами, указанный JAR-файл добавляется в системный путь классов целевой виртуальной машины, а метод agentmain класса агента, заданный атрибутом Agent-Class в манифесте JAR-файла, вызывается. Метод завершается после завершения метода agentmain.

public void loadAgent(String agent) throws AgentLoadException, AgentInitializationException, IOException

Загружает агента.

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

loadAgent(agent, null);

public abstract Properties getSystemProperties() throws IOException

Возвращает текущие системные свойства целевой виртуальной машины.

Этот метод возвращает системные свойства целевой виртуальной машины. Свойства, ключ или значение которых не является String, не включаются. Метод приблизительно эквивалентен вызову метода System.getProperties в целевой виртуальной машине, за исключением того, что свойства с ключом или значением, не являющимся String, не включаются.

Этот метод обычно используется для выбора агента, который будет загружен в целевую виртуальную машину с помощью loadAgent или loadAgentLibrary. Например, свойства java.home или user.dir можно использовать для формирования пути к библиотеке агента или JAR-файлу.

public abstract Properties getAgentProperties() throws IOException

Возвращает текущие свойства агента целевой виртуальной машины.

Целевая виртуальная машина может поддерживать список свойств для агентов. Способ их хранения, имена свойств и допустимые типы значений зависят от реализации. Свойства агента обычно используются для хранения конечных точек связи и других сведений о конфигурации агента. Например, агент отладчика может создать свойство агента для адреса транспортного механизма.

Этот метод возвращает свойства агента, ключ и значение которых являются String. Свойства, ключ или значение которых не является String, не включаются. Если целевая виртуальная машина не поддерживает свойства агента, возвращается пустой список свойств.

public abstract void startManagementAgent(Properties agentProperties) throws IOException

Запускает агент управления JMX в целевой виртуальной машине.

Свойства конфигурации совпадают со свойствами, указываемыми в командной строке при запуске агента управления JMX. Как и в случае с командной строкой, необходимо указать как минимум свойство com.sun.management.jmxremote.port.

Дополнительные сведения см. в онлайн-документации «Мониторинг и управление с использованием технологии JMX».

public abstract String startLocalManagementAgent() throws IOException

Запускает локальный агент управления JMX в целевой виртуальной машине.

Дополнительные сведения см. в онлайн-документации «Мониторинг и управление с использованием технологии JMX».

public int hashCode()

Возвращает хеш-код этого объекта VirtualMachine. Хеш-код основан на компонентах VirtualMachine и соответствует общему контракту метода Object.hashCode.

public boolean equals(Object ob)

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

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

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

public String toString()

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