compact3

java.lang.management

Класс MemoryUsage

java.lang. Объект

java.lang.management. MemoryUsage

public class MemoryUsage
extends Object

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

Объект MemoryUsage содержит четыре значения:

init	представляет начальный объем памяти (в байтах), который виртуальная машина Java запрашивает от операционной системы на управление памятью во время запуска. Виртуальная машина Java может запросить дополнительную память от операционной системы и может также выпустить память к системе в течение долгого времени. Значение init может быть неопределено.
used	представляет объем памяти, в настоящий момент используемый (в байтах).
committed	представляет объем памяти (в байтах), который, как гарантируют, будет доступен для использования виртуальной машиной Java. Количество фиксировавшей памяти может измениться в течение долгого времени (увеличение или уменьшение). Виртуальная машина Java может выпустить память к системе, и committed мог быть меньше чем init. committed всегда будет больше чем или равным used.
max	представляет максимальный объем памяти (в байтах), который может использоваться для управления памятью. Его значение может быть неопределено. Максимальный объем памяти может измениться в течение долгого времени если определено. Количество используемой и фиксировавшей памяти всегда будет меньше чем или равно max, если max будет определен. Выделение памяти может перестать работать, если бы оно пытается увеличить используемую память так, что used > committed, даже если used <= max все еще был бы истиной (например, когда система низка на виртуальной памяти).

Ниже изображение, показывая пример пула памяти:

        +----------------------------------------------+
        +////////////////           |                  +
        +////////////////           |                  +
        +----------------------------------------------+

        |--------|
           init
        |---------------|
               used
        |---------------------------|
                  committed
        |----------------------------------------------|
                            max
 

Отображение MXBean

MemoryUsage отображается на a CompositeData с атрибутами как определено в from метод.

С тех пор:

1.5

Сводка конструктора

Конструкторы

Конструктор и Описание
MemoryUsage(long init, long used, long committed, long max) Создает объект MemoryUsage.

Сводка метода

Модификатор и Тип	Метод и Описание
static MemoryUsage	from(CompositeData cd) Возвращает объект MemoryUsage, представленный данным CompositeData.
long	getCommitted() Возвращает объем памяти в байтах, который фиксируется для виртуальной машины Java, чтобы использовать.
long	getInit() Возвращает объем памяти в байтах, которые виртуальная машина Java первоначально запрашивает от операционной системы на управление памятью.
long	getMax() Возвращает максимальный объем памяти в байтах, которые могут использоваться для управления памятью.
long	getUsed() Возвращает количество используемой памяти в байтах.
Строка	toString() Возвращает дескриптивное представление этого использования памяти.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Деталь конструктора

MemoryUsage

public MemoryUsage(long init,
                   long used,
                   long committed,
                   long max)

Создает объект MemoryUsage.

Параметры:

init - начальный объем памяти в байтах, которые выделяет виртуальная машина Java; или -1 если неопределенный.

used - количество используемой памяти в байтах.

committed - количество фиксировавшей памяти в байтах.

max - максимальный объем памяти в байтах, которые могут использоваться; или -1 если неопределенный.

Броски:

IllegalArgumentException - если

• значение init или max отрицательно, но не -1; или
• значение used или committed отрицательно; или
• used больше чем значение committed; или
• committed больше чем значение max max если определено.

Деталь метода

getInit

public long getInit()

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

Возвраты:

начальный размер памяти в байтах; -1 если неопределенный.

getUsed

public long getUsed()

Возвращает количество используемой памяти в байтах.

Возвраты:

количество используемой памяти в байтах.

getCommitted

public long getCommitted()

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

Возвраты:

количество фиксировавшей памяти в байтах.

getMax

public long getMax()

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

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

Возвраты:

максимальный объем памяти в байтах; -1 если неопределенный.

toString

public String toString()

Возвращает дескриптивное представление этого использования памяти.

Переопределения:

toString в class Object

Возвраты:

строковое представление объекта.

от

public static MemoryUsage from(CompositeData cd)

Возвращает объект MemoryUsage, представленный данным CompositeData. Данный CompositeData должен содержать следующие атрибуты:

Название атрибута	Ввести
init	java.lang.Long
используемый	java.lang.Long
фиксировавший	java.lang.Long
максимальный	java.lang.Long

Параметры:

cd - CompositeData, представляющий MemoryUsage

Возвраты:

объект MemoryUsage, представленный cd, если cd не является null; null иначе.

Броски:

IllegalArgumentException - если cd не представляет MemoryUsage с атрибутами, описанными выше.