Интерфейс RuntimeMXBean

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

public interface RuntimeMXBean
extends PlatformManagedObject

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

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

Идентификатор MXBean для runtime-системы в MBeanServer:

java.lang:type=Runtime

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

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

С:: 1.5
См. также:: ManagementFactory.getPlatformMXBeans(Class), Спецификация JMX., Способы доступа к MXBean

Методы

Модификатор и тип	Метод	Описание
`String`	`getBootClassPath()`	Возвращает путь к загрузчику начальных классов (boot class path), используемый bootstrap class loader для поиска файлов классов.
`String`	`getClassPath()`	Возвращает путь к классовой библиотеке Java (Java class path), используемый system class loader для поиска файлов классов.
`List<String>`	`getInputArguments()`	Возвращает аргументы, переданные виртуальной машине Java, не включая аргументы для метода `main`.
`String`	`getLibraryPath()`	Возвращает путь к библиотекам Java.
`String`	`getManagementSpecVersion()`	Возвращает версию спецификации интерфейса управления, реализованного выполняющейся виртуальной машиной Java.
`String`	`getName()`	Возвращает имя выполняющейся виртуальной машины Java.
`default long`	`getPid()`	Возвращает идентификатор процесса выполняющейся виртуальной машины 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 механизм boot class path, используемый bootstrap class loader для поиска файлов классов.

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

getObjectName

Методы

getPid

default long getPid()

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

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

getName

String getName()

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

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

getVmName

String getVmName()

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

Возвращает:: имя реализации виртуальной машины Java.
Исключения:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.
См. также:: SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getVmVendor

String getVmVendor()

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

Возвращает:: поставщика реализации виртуальной машины Java.
Исключения:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.
См. также:: SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getVmVersion

String getVmVersion()

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

Возвращает:: версию реализации виртуальной машины Java.
Исключения:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.
См. также:: SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getSpecName

String getSpecName()

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

Возвращает:: имя спецификации виртуальной машины Java.
Исключения:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.
См. также:: SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getSpecVendor

String getSpecVendor()

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

Возвращает:: поставщика спецификации виртуальной машины Java.
Исключения:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.
См. также:: SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getSpecVersion

String getSpecVersion()

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

Возвращает:: версию спецификации виртуальной машины Java.
Исключения:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.
См. также:: SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getManagementSpecVersion

String getManagementSpecVersion()

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

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

getClassPath

String getClassPath()

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

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

Возвращает:: путь к классам Java.
Исключения:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.
См. также:: SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getLibraryPath

String getLibraryPath()

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

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

Возвращает:: путь к библиотекам Java.
Исключения:: SecurityException - если существует менеджер безопасности, и его метод checkPropertiesAccess не разрешает доступ к этой системной переменной.
См. также:: SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

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, 2020, 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/11/docs/api/java.management/java/lang/management/RuntimeMXBean.html