Интерфейс HotSpotDiagnosticMXBean

Все суперинтерфейсы:: PlatformManagedObject

public interface HotSpotDiagnosticMXBean extends PlatformManagedObject

Интерфейс управления диагностикой для виртуальной машины HotSpot.

МBean диагностики регистрируется в сервере управления платформы, как и другие платформенные MBeans.

Идентификатор для уникальной идентификации MBean диагностики в сервере управления:

com.sun.management:type=HotSpotDiagnostic

.* Его можно получить, вызвав метод PlatformManagedObject.getObjectName(). Все методы выбрасывают исключение NullPointerException , если какой-либо аргумент имеет null , если не указано иное.

См. также:

ManagementFactory.getPlatformMXBeans(Class)

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

Модификатор и тип	Метод	Описание
`void`	`dumpHeap(String outputFile, boolean live)`	Выводит дамп кучи в файл `outputFile` в том же формате, что и дамп кучи hprof.
`List<VMOption>`	`getDiagnosticOptions()`	Возвращает список объектов `VMOption` для всех диагностических опций.
`VMOption`	`getVMOption(String name)`	Возвращает объект `VMOption` для опции VM с заданным именем.
`void`	`setVMOption(String name, String value)`	Устанавливает опцию VM с заданным именем в указанное значение.

Методы, объявленные в интерфейсе java.lang.management.PlatformManagedObject

getObjectName

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

dumpHeap

void dumpHeap(String outputFile, boolean live) throws IOException

Выводит дамп кучи в файл outputFile в том же формате, что и дамп кучи hprof.

Если этот метод вызывается удаленно из другого процесса, вывод дампа кучи записывается в файл с именем outputFile на машине, где запущена целевая VM. Если outputFile - относительный путь, он относится к рабочей директории, в которой была запущена целевая VM.

Параметры:: outputFile - имя файла (зависит от ОС); live - если true дампить только активные объекты, т.е. объекты, доступные из других объектов
Исключения:: IOException - если файл outputFile уже существует, не может быть создан, открыт или записан.; UnsupportedOperationException - если эта операция не поддерживается.; IllegalArgumentException - если outputFile не оканчивается на ".hprof".; NullPointerException - если outputFile имеет null.; SecurityException - Если существует менеджер безопасности и его метод SecurityManager.checkWrite(java.lang.String) запрещает запись в указанный файл или вызывающий объект не имеет разрешения ManagmentPermission("control").

getDiagnosticOptions

List<VMOption> getDiagnosticOptions()

Возвращает список объектов VMOption для всех диагностических опций. Диагностическая опция - это опция VM writeable, которая может быть установлена динамически в основном для отладки и диагностики.

Возвращает:: список объектов VMOption для всех диагностических опций.

getVMOption

VMOption getVMOption(String name)

Возвращает объект VMOption для опции VM с заданным именем.

Возвращает:: объект VMOption для опции VM с заданным именем.
Исключения:: NullPointerException - если имя имеет null.; IllegalArgumentException - если опция VM с заданным именем не существует.

setVMOption

void setVMOption(String name, String value)

Устанавливает опцию VM с заданным именем в указанное значение. Новое значение будет отражено в новом объекте VMOption , возвращаемом методом getVMOption(java.lang.String) или методом getDiagnosticOptions(). Этот метод не изменяет значение объекта VMOption.

Параметры:: name - Имя опции VM; value - Новое значение опции VM для установки
Исключения:: IllegalArgumentException - если опция VM с заданным именем не существует.; IllegalArgumentException - если новое значение некорректно.; IllegalArgumentException - если опция VM не может быть изменена.; NullPointerException - если имя или значение имеет null.; SecurityException - если менеджер безопасности существует и у вызывающего объекта нет разрешения ManagementPermission("control").

© 1993, 2021, 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/17/docs/api/jdk.management/com/sun/management/HotSpotDiagnosticMXBean.html