Интерфейс HotSpotDiagnosticMXBean

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

public interface HotSpotDiagnosticMXBean
extends PlatformManagedObject

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

Диагностический MBean регистрируется в платформенном MBeanServer, как и другие платформенные MBeans.

Идентификатор для уникальной идентификации диагностического MXBean в рамках MBeanServer:

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) запрещает запись в указанный файл, или у вызывающего объекта отсутствует право ManagementPermission("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").