Класс 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()`	Возвращает время, затраченное на эту сборку мусора, в миллисекундах.
`long`	`getEndTime()`	Возвращает время окончания этой сборки мусора в миллисекундах с момента запуска виртуальной машины Java.
`long`	`getId()`	Возвращает идентификатор этой сборки мусора, то есть количество сборок, выполненных этим сборщиком.
`Map<String, MemoryUsage>`	`getMemoryUsageAfterGc()`	Возвращает использование памяти всеми пулами памяти в конце этой сборки мусора.
`Map<String, MemoryUsage>`	`getMemoryUsageBeforeGc()`	Возвращает использование памяти всеми пулами памяти в начале этой сборки мусора.
`long`	`getStartTime()`	Возвращает время начала этой сборки мусора в миллисекундах с момента запуска виртуальной машины 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

getId

public long getId()

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

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

getStartTime

public long getStartTime()

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

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

getEndTime

public long getEndTime()

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

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

getDuration

public long getDuration()

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

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

getMemoryUsageBeforeGc

public Map<String, MemoryUsage> getMemoryUsageBeforeGc()

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

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

getMemoryUsageAfterGc

public Map<String, MemoryUsage> getMemoryUsageAfterGc()

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

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

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.

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

Определено в:: 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.