Spec-Zone.ru › OpenJDK 21

Интерфейс 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
См. также:
  • ManagementFactory.getPlatformMXBeans(Class)
  • Спецификация JMX.
  • Способы доступа к MXBean

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

Модификатор и тип Метод Описание
String getBootClassPath()
Возвращает путь к загрузочному классу, который используется загрузчиком Bootstrap для поиска файлов классов.
String getClassPath()
Возвращает путь к классу Java, который используется системным загрузчиком для поиска файлов классов.
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 механизм пути к загрузочному классу, используемый загрузчиком Bootstrap для поиска файлов классов.

Методы, объявленные в интерфейсе 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, 2023, 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/21/docs/api/java.management/java/lang/management/RuntimeMXBean.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API