Интерфейс OperatingSystemMXBean

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

Все известные подинтерфейсы:: UnixOperatingSystemMXBean

public interface OperatingSystemMXBean extends OperatingSystemMXBean

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

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

Объект OperatingSystemMXBean, возвращаемый методом ManagementFactory.getOperatingSystemMXBean(), является экземпляром класса реализации этого интерфейса или интерфейса UnixOperatingSystemMXBean в зависимости от базовой операционной системы.

Начиная с:: 1.5

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

Модификатор и тип	Метод	Описание
`long`	`getCommittedVirtualMemorySize()`	Возвращает объём виртуальной памяти в байтах, гарантированно доступный выполняющемуся процессу, или `-1`, если эта операция не поддерживается.
`double`	`getCpuLoad()`	Возвращает «недавнее использование ЦП» операционной среды.
`long`	`getFreeMemorySize()`	Возвращает объём свободной памяти в байтах.
`default long`	`getFreePhysicalMemorySize()`	Устарело. Вместо этого метода с исторически сложившимся названием используйте `getFreeMemorySize()`.
`long`	`getFreeSwapSpaceSize()`	Возвращает объём свободного пространства подкачки в байтах.
`double`	`getProcessCpuLoad()`	Возвращает «недавнее использование ЦП» процессом виртуальной машины Java.
`long`	`getProcessCpuTime()`	Возвращает время ЦП, использованное процессом, в котором работает виртуальная машина Java, в наносекундах.
`default double`	`getSystemCpuLoad()`	Устарело. Вместо этого метода с исторически сложившимся названием используйте `getCpuLoad()`.
`long`	`getTotalMemorySize()`	Возвращает общий объём памяти в байтах.
`default long`	`getTotalPhysicalMemorySize()`	Устарело. Вместо этого метода с исторически сложившимся названием используйте `getTotalMemorySize()`.
`long`	`getTotalSwapSpaceSize()`	Возвращает общий объём пространства подкачки в байтах.

Методы, объявленные в интерфейсе OperatingSystemMXBean

getArch, getAvailableProcessors, getName, getSystemLoadAverage, getVersion

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

getObjectName

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

getCommittedVirtualMemorySize

long getCommittedVirtualMemorySize()

Возвращает объём виртуальной памяти в байтах, гарантированно доступный выполняющемуся процессу, или -1, если эта операция не поддерживается.

Возвращает:: объём виртуальной памяти в байтах, гарантированно доступный выполняющемуся процессу, или -1, если эта операция не поддерживается.

getTotalSwapSpaceSize

long getTotalSwapSpaceSize()

Возвращает общий объём пространства подкачки в байтах.

Возвращает:: общий объём пространства подкачки в байтах.

getFreeSwapSpaceSize

long getFreeSwapSpaceSize()

Возвращает объём свободного пространства подкачки в байтах.

Возвращает:: объём свободного пространства подкачки в байтах.

getProcessCpuTime

long getProcessCpuTime()

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

Возвращает:: время ЦП, использованное процессом, в наносекундах, или -1, если эта операция не поддерживается.

getFreePhysicalMemorySize

@Deprecated(since="14") default long getFreePhysicalMemorySize()

Устарело.

Вместо этого метода с исторически сложившимся названием используйте getFreeMemorySize().

Возвращает объём свободной физической памяти в байтах.

Требования к реализации:: Эта реализация должна возвращать то же значение, что и getFreeMemorySize().
Возвращает:: объём свободной физической памяти в байтах.

getFreeMemorySize

long getFreeMemorySize()

Возвращает объём свободной памяти в байтах.

Возвращает:: объём свободной памяти в байтах.
Начиная с:: 14

getTotalPhysicalMemorySize

@Deprecated(since="14") default long getTotalPhysicalMemorySize()

Устарело.

Вместо этого метода с исторически сложившимся названием используйте getTotalMemorySize().

Возвращает общий объём физической памяти в байтах.

Требования к реализации:: Эта реализация должна возвращать то же значение, что и getTotalMemorySize().
Возвращает:: общий объём физической памяти в байтах.

getTotalMemorySize

long getTotalMemorySize()

Возвращает общий объём памяти в байтах.

Возвращает:: общий объём памяти в байтах.
Начиная с:: 14

getSystemCpuLoad

@Deprecated(since="14") default double getSystemCpuLoad()

Устарело.

Вместо этого метода с исторически сложившимся названием используйте getCpuLoad().

Возвращает «недавнее использование ЦП» всей системы. Это значение типа double в интервале [0.0,1.0]. Значение 0.0 означает, что все процессоры простаивали в течение наблюдаемого недавнего периода времени, а значение 1.0 означает, что все процессоры активно работали на 100% в течение наблюдаемого недавнего периода. Недавний период наблюдения зависит от реализации и обычно соответствует времени с момента последнего вызова этого метода или getCpuLoad(). Для самого первого вызова недавний период наблюдения не определён. В зависимости от выполняемых действий возможны любые значения от 0.0 до 1.0. Если данные о недавнем использовании ЦП недоступны, метод возвращает отрицательное значение.

Примечание к API:: Вызывающим сторонам следует учитывать, что другие вызывающие стороны могут влиять на период наблюдения и результат.
Требования к реализации:: Эта реализация должна возвращать то же значение, что и getCpuLoad().
Возвращает:: «недавнее использование ЦП» всей системы; отрицательное значение, если данные недоступны.
Начиная с:: 1.7

getCpuLoad

double getCpuLoad()

Возвращает «недавнее использование ЦП» операционной среды. Это значение типа double в интервале [0.0,1.0]. Значение 0.0 означает, что все процессоры простаивали в течение наблюдаемого недавнего периода времени, а значение 1.0 означает, что все процессоры активно работали на 100% в течение наблюдаемого недавнего периода. Недавний период наблюдения зависит от реализации и обычно соответствует времени с момента последнего вызова этого метода или getSystemCpuLoad(). Для самого первого вызова недавний период наблюдения не определён. В зависимости от выполняемых действий возможны любые значения от 0.0 до 1.0. Если данные о недавнем использовании ЦП недоступны, метод возвращает отрицательное значение.

Примечание к API:: Вызывающим сторонам следует учитывать, что другие вызывающие стороны могут влиять на период наблюдения и результат.
Возвращает:: «недавнее использование ЦП» всей операционной среды; отрицательное значение, если данные недоступны.
Начиная с:: 14

getProcessCpuLoad

double getProcessCpuLoad()

Возвращает «недавнее использование ЦП» процессом виртуальной машины Java. Это значение типа double в интервале [0.0,1.0]. Значение 0.0 означает, что ни на одном процессоре не выполнялись потоки процесса JVM в течение наблюдаемого недавнего периода времени, а значение 1.0 означает, что на всех процессорах потоки JVM активно выполнялись на 100% в течение наблюдаемого недавнего периода. К потокам JVM относятся потоки приложения, а также внутренние потоки JVM. Недавний период наблюдения зависит от реализации и обычно соответствует времени с момента последнего вызова этого метода. Для самого первого вызова недавний период наблюдения не определён. В зависимости от активности процесса JVM и всей системы возможны любые значения от 0.0 до 1.0. Если данные о недавнем использовании ЦП виртуальной машиной Java недоступны, метод возвращает отрицательное значение.

Примечание к API:: Вызывающим сторонам следует учитывать, что другие вызывающие стороны могут влиять на период наблюдения и результат.
Возвращает:: «недавнее использование ЦП» процессом виртуальной машины Java; отрицательное значение, если данные недоступны.
Начиная с:: 1.7

© 1993, 2025, 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/25/docs/api/jdk.management/com/sun/management/OperatingSystemMXBean.html