Класс GcInfo

java.lang.Object

com.sun.management.GcInfo

Все реализуемые интерфейсы:: CompositeData, CompositeDataView

public class GcInfo extends Object implements CompositeData, CompositeDataView

Информация о сборке мусора. Она содержит следующую информацию об одной сборке мусора, а также атрибуты, специфичные для GC:

Время начала

Время окончания

Длительность

Использование памяти до начала сборки

Использование памяти после окончания сборки

GcInfo является CompositeData. Атрибуты, специфичные для GC, можно получить через интерфейс CompositeData. Это исторический артефакт, и другим классам не следует копировать этот шаблон. Вместо этого используйте CompositeDataView.

Сопоставление MXBean

GcInfo сопоставляется с CompositeData с атрибутами, указанными в методе from.

Начиная с:: 1.5

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

Модификатор и тип	Метод	Описание
`boolean`	`containsKey(String key)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `CompositeData` содержит элемент с именем `key`.
`boolean`	`containsValue(Object value)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `CompositeData` содержит элемент со значением `value`.
`boolean`	`equals(Object obj)`	Сравнивает указанный параметр `obj` с этим экземпляром `CompositeData` на равенство.
`static GcInfo`	`from(CompositeData cd)`	Возвращает объект `GcInfo`, представленный заданным `CompositeData`.
`Object`	`get(String key)`	Возвращает значение элемента с именем `key`.
`Object[]`	`getAll(String[] keys)`	Возвращает массив значений элементов, имена которых заданы в `keys`, в том же порядке, что и в `keys`.
`CompositeType`	`getCompositeType()`	Возвращает составной тип этого экземпляра составных данных.
`long`	`getDuration()`	Возвращает время, затраченное на эту сборку GC, в миллисекундах.
`long`	`getEndTime()`	Возвращает время окончания этой сборки GC в миллисекундах с момента запуска виртуальной машины Java.
`long`	`getId()`	Возвращает идентификатор этой сборки мусора — количество сборок, выполненных этим сборщиком.
`Map<String, MemoryUsage>`	`getMemoryUsageAfterGc()`	Возвращает использование памяти всеми пулами памяти по окончании этой сборки GC.
`Map<String, MemoryUsage>`	`getMemoryUsageBeforeGc()`	Возвращает использование памяти всеми пулами памяти в начале этой сборки GC.
`long`	`getStartTime()`	Возвращает время начала этой сборки GC в миллисекундах с момента запуска виртуальной машины Java.
`int`	`hashCode()`	Возвращает значение хеш-кода этого экземпляра `CompositeData`.
`CompositeData`	`toCompositeData(CompositeType ct)`	Возвращает представление `CompositeData` этого `GcInfo`, включая любые атрибуты, специфичные для GC.
`String`	`toString()`	Возвращает строковое представление этого экземпляра `CompositeData`.
`Collection<?>`	`values()`	Возвращает неизменяемое представление Collection значений элементов, содержащихся в этом экземпляре `CompositeData`.

Методы, объявленные в классе Object

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

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

getId

public long getId()

Возвращает идентификатор этой сборки мусора — количество сборок, выполненных этим сборщиком.

Возвращает:: идентификатор этой сборки мусора — количество сборок, выполненных этим сборщиком.

getStartTime

public long getStartTime()

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

Возвращает:: время начала этой сборки GC.

getEndTime

public long getEndTime()

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

Возвращает:: время окончания этой сборки GC.

getDuration

public long getDuration()

Возвращает время, затраченное на эту сборку GC, в миллисекундах.

Возвращает:: время, затраченное на эту сборку GC, в миллисекундах.

getMemoryUsageBeforeGc

public Map<String, MemoryUsage> getMemoryUsageBeforeGc()

Возвращает использование памяти всеми пулами памяти в начале этой сборки GC. Этот метод возвращает Map, сопоставляющий имя пула памяти с использованием памяти соответствующего пула до начала GC.

Возвращает:: Map имен пулов памяти и использования памяти пулов до начала GC.

getMemoryUsageAfterGc

public Map<String, MemoryUsage> getMemoryUsageAfterGc()

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

Возвращает:: Map имен пулов памяти и использования памяти пулов по завершении GC.

from

public static GcInfo from(CompositeData cd)

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

описание

Имя атрибута Тип

index java.lang.Long

startTime java.lang.Long

endTime java.lang.Long

memoryUsageBeforeGc javax.management.openmbean.TabularData

memoryUsageAfterGc javax.management.openmbean.TabularData

описание
Имя атрибута	Тип
index	`java.lang.Long`
startTime	`java.lang.Long`
endTime	`java.lang.Long`
memoryUsageBeforeGc	`javax.management.openmbean.TabularData`
memoryUsageAfterGc	`javax.management.openmbean.TabularData`

Возвращает:: объект GcInfo, представленный cd, если cd не равен null; в противном случае — null.
Выбрасывает:: IllegalArgumentException — если cd не представляет объект GcInfo с описанными выше атрибутами.

containsKey

public boolean containsKey(String key)

Описание скопировано из интерфейса: CompositeData

Возвращает true тогда и только тогда, когда этот экземпляр CompositeData содержит элемент с именем key. Если key — пустая строка или null, этот метод просто возвращает false.

Определено в:: containsKey в интерфейсе CompositeData
Параметры:: key — ключ для проверки.
Возвращает:: true, если этот CompositeData содержит ключ.

containsValue

public boolean containsValue(Object value)

Описание скопировано из интерфейса: CompositeData

Возвращает true тогда и только тогда, когда этот экземпляр CompositeData содержит элемент со значением value.

Определено в:: containsValue в интерфейсе CompositeData
Параметры:: value — значение для проверки.
Возвращает:: true, если этот CompositeData содержит значение.

equals

public boolean equals(Object obj)

Описание скопировано из интерфейса: CompositeData

Сравнивает указанный параметр obj с этим экземпляром CompositeData на равенство.

Возвращает true тогда и только тогда, когда истинны все следующие утверждения:

obj не равен null,
obj также реализует интерфейс CompositeData,
их составные типы равны
их содержимое, то есть пары (имя, значение), совпадает. Если значение в содержимом является массивом, сравнение значений выполняется так, как если бы для массивов ссылочных типов объектов вызывался метод deepEquals, либо соответствующая перегруженная версия Arrays.equals(e1,e2) для массивов примитивных типов

Это обеспечивает корректную работу метода equals для параметров obj, являющихся другими реализациями интерфейса CompositeData, с учетом ограничений, указанных в методе equals интерфейса java.util.Collection.

Определено в:

equals в интерфейсе CompositeData

Переопределяет:

equals в классе Object

Параметры:

obj — объект для сравнения на равенство с этим экземпляром CompositeData.

Возвращает:

true, если указанный объект равен этому экземпляру CompositeData.

См. также:

get

public Object get(String key)

Описание скопировано из интерфейса: CompositeData

Возвращает значение элемента с именем key.

Определено в:: get в интерфейсе CompositeData
Параметры:: key — имя элемента.
Возвращает:: значение, связанное с этим ключом.

getAll

public Object[] getAll(String[] keys)

Описание скопировано из интерфейса: CompositeData

Возвращает массив значений элементов, имена которых заданы в keys, в том же порядке, что и в keys.

Определено в:: getAll в интерфейсе CompositeData
Параметры:: keys — имена элементов.
Возвращает:: значения, соответствующие ключам.

getCompositeType

public CompositeType getCompositeType()

Описание скопировано из интерфейса: CompositeData

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

Определено в:: getCompositeType в интерфейсе CompositeData
Возвращает:: тип этих CompositeData.

hashCode

public int hashCode()

Описание скопировано из интерфейса: CompositeData

Возвращает значение хеш-кода этого экземпляра CompositeData.

Хеш-код экземпляра CompositeData представляет собой сумму хеш-кодов всех информационных элементов, используемых при сравнении equals (то есть его составного типа и значений всех элементов).

Это гарантирует, что t1.equals(t2) влечет за собой t1.hashCode()==t2.hashCode() для любых двух экземпляров CompositeData t1 и t2, как того требует общий контракт метода Object.hashCode().

Хеш-код каждого значения элемента добавляется к возвращаемому хеш-коду. Если значение элемента является массивом, его хеш-код вычисляется так, как если бы для массивов ссылочных типов объектов вызывался метод deepHashCode, либо соответствующая перегруженная версия Arrays.hashCode(e) для массивов примитивных типов.

Определено в:

hashCode в интерфейсе CompositeData

Переопределяет:

hashCode в классе Object

Возвращает:

значение хеш-кода этого экземпляра CompositeData

См. также:

toString

public String toString()

Описание скопировано из интерфейса: CompositeData

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

Строковое представление состоит из имени реализующего класса, строкового представления составного типа этого экземпляра и строкового представления содержимого (то есть списка соответствий itemName=itemValue).

Определено в:: toString в интерфейсе CompositeData
Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого экземпляра CompositeData

values

public Collection<?> values()

Описание скопировано из интерфейса: CompositeData

Возвращает неизменяемое представление Collection значений элементов, содержащихся в этом экземпляре CompositeData. Итератор возвращаемой коллекции будет возвращать значения в порядке возрастания лексикографической сортировки соответствующих имен элементов.

Определено в:: values в интерфейсе CompositeData
Возвращает:: значения.

toCompositeData

public CompositeData toCompositeData(CompositeType ct)

Возвращает представление CompositeData этого GcInfo, включая любые атрибуты, специфичные для GC. Возвращаемое значение будет содержать как минимум все атрибуты, описанные в методе from, а также, возможно, другие атрибуты.

Определено в:: toCompositeData в интерфейсе CompositeDataView
Параметры:: ct — CompositeType, которое ожидает вызывающий код. Этот параметр игнорируется и может быть равен null.
Возвращает:: представление CompositeData.

© 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/GcInfo.html