Класс GarbageCollectionNotificationInfo

java.lang.Object

com.sun.management.GarbageCollectionNotificationInfo

Все реализованные интерфейсы:: CompositeDataView

public class GarbageCollectionNotificationInfo extends Object implements CompositeDataView

Информация о сборке мусора

Уведомление о сборке мусора отправляется компонентом GarbageCollectorMXBean после завершения виртуальной машиной Java действия по сборке мусора. Отправляемое уведомление содержит информацию о состоянии памяти при сборке мусора:

Имя сборщика мусора, использованного для выполнения сборки.
Действие, выполненное сборщиком мусора.
Причина выполнения действия по сборке мусора.
Объект GcInfo, содержащий статистику цикла GC (время начала и окончания), а также сведения об использовании памяти до и после цикла GC.

Объект CompositeData, представляющий объект GarbageCollectionNotificationInfo, сохраняется в пользовательских данных уведомления. Метод from предназначен для преобразования CompositeData в объект GarbageCollectionNotificationInfo. Например:

     Notification notif;

     // receive the notification emitted by a GarbageCollectorMXBean and set to notif
     ...

     String notifType = notif.getType();
     if (notifType.equals(GarbageCollectionNotificationInfo.GARBAGE_COLLECTION_NOTIFICATION)) {
         // retrieve the garbage collection notification information
         CompositeData cd = (CompositeData) notif.getUserData();
         GarbageCollectionNotificationInfo info = GarbageCollectionNotificationInfo.from(cd);
         ....
     }

Тип уведомления, отправляемого компонентом GarbageCollectorMXBean:

Уведомление о сборке мусора.
Используется каждым уведомлением, отправляемым сборщиком мусора; сведения об уведомлении содержатся в строке действия.

С момента:: 1.7

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`GARBAGE_COLLECTION_NOTIFICATION`	Тип уведомления, указывающий на то, что виртуальная машина Java завершила цикл сборки мусора.

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

Конструктор	Описание
`GarbageCollectionNotificationInfo(String gcName, String gcAction, String gcCause, GcInfo gcInfo)`	Создает объект `GarbageCollectionNotificationInfo`.

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

Модификатор и тип	Метод	Описание
`static GarbageCollectionNotificationInfo`	`from(CompositeData cd)`	Возвращает объект `GarbageCollectionNotificationInfo`, представленный заданным объектом `CompositeData`.
`String`	`getGcAction()`	Возвращает действие, выполненное сборщиком мусора.
`String`	`getGcCause()`	Возвращает причину сборки мусора.
`GcInfo`	`getGcInfo()`	Возвращает сведения GC о последней сборке мусора.
`String`	`getGcName()`	Возвращает имя сборщика мусора, использованного для выполнения сборки.
`CompositeData`	`toCompositeData(CompositeType ct)`	Возвращает объект `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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного интервала реального времени.

Подробное описание полей

GARBAGE_COLLECTION_NOTIFICATION

public static final String GARBAGE_COLLECTION_NOTIFICATION

Тип уведомления, указывающий на то, что виртуальная машина Java завершила цикл сборки мусора. Это уведомление отправляется компонентом GarbageCollectorMXBean. Значение этого типа уведомления — com.sun.management.gc.notification.

См. также:

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

GarbageCollectionNotificationInfo

public GarbageCollectionNotificationInfo(String gcName, String gcAction, String gcCause, GcInfo gcInfo)

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

Параметры:: gcName — Имя сборщика мусора, использованного для выполнения сборки; gcAction — Имя действия, выполненного сборщиком мусора; gcCause — Причина выполнения действия по сборке мусора; gcInfo — объект GcInfo, предоставляющий статистику цикла GC

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

getGcName

public String getGcName()

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

Возвращает:: имя сборщика мусора, использованного для выполнения сборки

getGcAction

public String getGcAction()

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

Возвращает:: действие, выполненное сборщиком мусора

getGcCause

public String getGcCause()

Возвращает причину сборки мусора.

Возвращает:: причина сборки мусора

getGcInfo

public GcInfo getGcInfo()

Возвращает сведения GC о последней сборке мусора.

Возвращает:: сведения GC о последней сборке мусора

from

public static GarbageCollectionNotificationInfo from(CompositeData cd)

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

описание

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

gcName java.lang.String

gcAction java.lang.String

gcCause java.lang.String

gcInfo javax.management.openmbean.CompositeData

описание
Имя атрибута	Тип
gcName	`java.lang.String`
gcAction	`java.lang.String`
gcCause	`java.lang.String`
gcInfo	`javax.management.openmbean.CompositeData`

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

toCompositeData

public CompositeData toCompositeData(CompositeType ct)

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

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

Определено в:: toCompositeData в интерфейсе CompositeDataView
Параметры:: ct — Ожидаемый CompositeType возвращаемого значения. Если возвращаемое значение является cd, то cd.getCompositeType().equals(ct) должно быть равно true. Обычно это объясняется тем, что cd является объектом CompositeDataSupport, созданным с ct в качестве CompositeType.
Возвращает:: 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.