Класс 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 поставщика присоединения, чтобы подключиться к целевой VM.

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 развертывается платформенно-специфическим способом, но обычно это эквивалент динамической библиотеки на платформе. В качестве альтернативы, он может быть статически связан с VM. Этот метод вызывает загрузку указанной библиотеки агента в целевую VM (если она еще не загружена или не статически связана с VM). Затем он заставляет целевую VM вызвать функцию Agent_OnAttach или, для статически связанного агента с именем 'L', функцию Agent_OnAttach_L, как указано в спецификации JVM Tools Interface. Обратите внимание, что функция Agent_OnAttach[_L] вызывается даже если библиотека агента была загружена до вызова этого метода.

Предоставленная библиотека агента — это имя библиотеки агента. Оно интерпретируется целевой виртуальной машиной способом, зависящим от реализации. Обычно реализация преобразует имя библиотеки в имя файла, специфичное для операционной системы. Например, в системах UNIX имя L может быть преобразовано в libL.so, и найден с помощью пути поиска, указанного в переменной среды LD_LIBRARY_PATH. Если агент с именем 'L' статически связан с VM, то VM должна экспортировать функцию с именем 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.