Класс GarbageCollectionNotificationInfo

java.lang.Object

com.sun.management.GarbageCollectionNotificationInfo

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

public class GarbageCollectionNotificationInfo extends Object implements CompositeDataView

Сведения об очистке памяти

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

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

Объект CompositeData, представляющий объект GarbageCollectionNotificationInfo, хранится в userdata объекта уведомления. Метод 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:

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

С версии:: 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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.management/com/sun/management/GarbageCollectionNotificationInfo.html