Интерфейс RuntimeMXBean

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

public interface RuntimeMXBean extends PlatformManagedObject

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

Виртуальная машина Java имеет единственный экземпляр класса-реализации этого интерфейса. Этот экземпляр, реализующий этот интерфейс, является MXBean, который можно получить, вызвав метод ManagementFactory.getRuntimeMXBean() или из метода platform MBeanServer.

Идентификатор ObjectName для уникальной идентификации MXBean для среды выполнения внутри MBeanServer:

java.lang:type=Runtime

Его можно получить, вызвав метод PlatformManagedObject.getObjectName().

Этот интерфейс определяет несколько удобных методов для доступа к системным свойствам виртуальной машины Java.

С:

1.5

См. также:

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

Модификатор и тип	Метод	Описание
`String`	`getBootClassPath()`	Возвращает путь к загрузчику базовых классов, используемый для поиска файлов классов.
`String`	`getClassPath()`	Возвращает путь к классу Java, используемый системным загрузчиком для поиска файлов классов.
`List<String>`	`getInputArguments()`	Возвращает входные аргументы, переданные виртуальной машине Java, которые не включают аргументы к методу `main`.
`String`	`getLibraryPath()`	Возвращает путь к библиотекам Java.
`String`	`getManagementSpecVersion()`	Возвращает версию спецификации интерфейса управления, реализованного работающей виртуальной машиной Java.
`String`	`getName()`	Возвращает имя работающей виртуальной машины Java.
`default long`	`getPid()`	Возвращает ID процесса, представляющий работающую виртуальную машину Java.
`String`	`getSpecName()`	Возвращает имя спецификации виртуальной машины Java.
`String`	`getSpecVendor()`	Возвращает поставщика спецификации виртуальной машины Java.
`String`	`getSpecVersion()`	Возвращает версию спецификации виртуальной машины Java.
`long`	`getStartTime()`	Возвращает время запуска виртуальной машины Java в миллисекундах.
`Map<String,String>`	`getSystemProperties()`	Возвращает карту имён и значений всех системных свойств.
`long`	`getUptime()`	Возвращает время работы виртуальной машины Java в миллисекундах.
`String`	`getVmName()`	Возвращает имя реализации виртуальной машины Java.
`String`	`getVmVendor()`	Возвращает поставщика реализации виртуальной машины Java.
`String`	`getVmVersion()`	Возвращает версию реализации виртуальной машины Java.
`boolean`	`isBootClassPathSupported()`	Проверяет, поддерживает ли виртуальная машина Java механизм пути к загрузчику базовых классов, используемый для поиска файлов классов.

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

getObjectName

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

getPid

default long getPid()

Возвращает идентификатор процесса (process ID), представляющий запущенную виртуальную машину Java.

Требования к реализации:: В стандартной реализации возвращается process ID текущего процесса (current process).
Возвращает:: идентификатор процесса, представляющий запущенную виртуальную машину Java.
С версии:: 10

getName

String getName()

Возвращает имя, представляющее запущенную виртуальную машину Java. Возвращаемая строка имени может быть произвольной, и реализация виртуальной машины Java может включать в неё платформоспецифичную полезную информацию. У каждой запущенной виртуальной машины может быть разное имя.

Возвращает:: имя, представляющее запущенную виртуальную машину Java.

getVmName

String getVmName()

Возвращает имя реализации виртуальной машины Java. Этот метод эквивалентен System.getProperty("java.vm.name").

Возвращает:

имя реализации виртуальной машины Java.

Исключения:

SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.

См. также:

getVmVendor

String getVmVendor()

Возвращает поставщика реализации виртуальной машины Java. Этот метод эквивалентен System.getProperty("java.vm.vendor").

Возвращает:

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

Исключения:

См. также:

getVmVersion

String getVmVersion()

Возвращает версию реализации виртуальной машины Java. Этот метод эквивалентен System.getProperty("java.vm.version").

Возвращает:

версию реализации виртуальной машины Java.

Исключения:

См. также:

getSpecName

String getSpecName()

Возвращает имя спецификации виртуальной машины Java. Этот метод эквивалентен System.getProperty("java.vm.specification.name").

Возвращает:

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

Исключения:

См. также:

getSpecVendor

String getSpecVendor()

Возвращает поставщика спецификации виртуальной машины Java. Этот метод эквивалентен System.getProperty("java.vm.specification.vendor").

Возвращает:

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

Исключения:

См. также:

getSpecVersion

String getSpecVersion()

Возвращает версию спецификации виртуальной машины Java. Этот метод эквивалентен System.getProperty("java.vm.specification.version").

Возвращает:

версию спецификации виртуальной машины Java.

Исключения:

См. также:

getManagementSpecVersion

String getManagementSpecVersion()

Возвращает версию спецификации интерфейса управления, реализованную запущенной виртуальной машиной Java.

Возвращает:: версия спецификации интерфейса управления, реализованную запущенной виртуальной машиной Java.

getClassPath

String getClassPath()

Возвращает путь к классам Java, используемый системным загрузчиком классов для поиска файлов классов. Этот метод эквивалентен System.getProperty("java.class.path").

Несколько путей в пути к классам Java разделены символом разделителя путей платформы виртуальной машины Java, которая контролируется.

Возвращает:

путь к классам Java.

Исключения:

См. также:

getLibraryPath

String getLibraryPath()

Возвращает путь к библиотекам Java. Этот метод эквивалентен System.getProperty("java.library.path").

Несколько путей в пути к библиотекам Java разделены символом разделителя путей платформы виртуальной машины Java, которая контролируется.

Возвращает:

путь к библиотекам Java.

Исключения:

См. также:

isBootClassPathSupported

boolean isBootClassPathSupported()

Проверяет, поддерживает ли виртуальная машина Java механизм пути к загрузчику начального класса для поиска файлов классов.

Возвращает:: true если виртуальная машина Java поддерживает механизм пути; false в противном случае.

getBootClassPath

String getBootClassPath()

Возвращает путь к загрузчику начального класса, который используется для поиска файлов классов.

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

Реализация виртуальной машины Java может не поддерживать механизм пути к загрузчику начального класса для поиска файлов классов. Метод isBootClassPathSupported() может быть использован для определения, поддерживает ли виртуальная машина Java этот метод.

Возвращает:: путь к загрузчику начального класса.
Исключения:: UnsupportedOperationException - если виртуальная машина Java не поддерживает эту операцию.; SecurityException - если существует менеджер безопасности и вызывающий код не имеет разрешения ManagementPermission("monitor").

getInputArguments

List<String> getInputArguments()

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

Некоторые реализации виртуальной машины Java могут получать входные аргументы из нескольких различных источников: например, аргументы, переданные приложением, запускающим виртуальную машину Java, такие как команда 'java', переменные окружения, конфигурационные файлы и т. д.

Обычно не все параметры командной строки для команды 'java' передаются виртуальной машине Java. Таким образом, возвращаемые входные аргументы могут не включать все параметры командной строки.

Доступ к MBeanServer:
Сопоставленный тип List<String> - String[].

Возвращает:: список объектов String; каждый элемент — это аргумент, переданный виртуальной машине Java.
Использует:: SecurityException - если существует менеджер безопасности, и у вызывающего объекта нет разрешения ManagementPermission("monitor").

getUptime

long getUptime()

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

Возвращает:: время работы виртуальной машины Java в миллисекундах.

getStartTime

long getStartTime()

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

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

getSystemProperties

Map<String,String> getSystemProperties()

Возвращает карту имён и значений всех системных свойств. Этот метод вызывает System.getProperties() для получения всех системных свойств. Свойства, имя или значение которых не является String, опущаются.

Доступ к MBeanServer:
Сопоставленный тип Map<String,String> — TabularData с двумя элементами в каждой строке следующим образом:

Имя и тип для каждого элемента
Имя элемента	Тип элемента
`key`	`String`
`value`	`String`

Возвращает:: карту имён и значений всех системных свойств.
Использует:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к системным свойствам.

© 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/java.management/java/lang/management/RuntimeMXBean.html