Класс RecordedObject

java.lang.Object

jdk.jfr.consumer.RecordedObject

Прямые известные подклассы:: RecordedClass, RecordedClassLoader, RecordedEvent, RecordedFrame, RecordedMethod, RecordedStackTrace, RecordedThread, RecordedThreadGroup

public sealed class RecordedObject extends Object permits RecordedEvent, RecordedClassLoader, RecordedClass, RecordedMethod, RecordedStackTrace, RecordedFrame, RecordedThread, RecordedThreadGroup

Составной тип данных, состоящий из одного или нескольких полей.

Этот класс предоставляет методы для выбора и запроса вложенных объектов с помощью объектов, разделённых точкой "." String (например, "aaa.bbb"). Метод вычисляет вложенный объект слева направо и, если часть null, выбрасывает NullPointerException.

Начиная с:: 9

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

Модификатор и тип	Метод	Описание
`final boolean`	`getBoolean(String name)`	Возвращает значение поля типа `boolean`.
`final byte`	`getByte(String name)`	Возвращает значение поля типа `byte`.
`final char`	`getChar(String name)`	Возвращает значение поля типа `char`.
`final RecordedClass`	`getClass(String name)`	Возвращает значение поля типа `Class`.
`final double`	`getDouble(String name)`	Возвращает значение поля типа `double` или другого примитивного типа, который можно преобразовать в тип `double` с помощью расширяющего преобразования.
`final Duration`	`getDuration(String name)`	Возвращает значение поля, представляющего временной интервал.
`List<ValueDescriptor>`	`getFields()`	Возвращает неизменяемый список полей этого объекта.
`final float`	`getFloat(String name)`	Возвращает значение поля типа `float` или другого примитивного типа, который можно преобразовать в тип `float` с помощью расширяющего преобразования.
`final Instant`	`getInstant(String name)`	Возвращает значение поля, представляющего временную метку.
`final int`	`getInt(String name)`	Возвращает значение поля типа `int` или другого примитивного типа, который можно преобразовать в тип `int` с помощью расширяющего преобразования.
`final long`	`getLong(String name)`	Возвращает значение поля типа `long` или другого примитивного типа, который можно преобразовать в тип `long` с помощью расширяющего преобразования.
`final short`	`getShort(String name)`	Возвращает значение поля типа `short` или другого примитивного типа, который можно преобразовать в тип `short` с помощью расширяющего преобразования.
`final String`	`getString(String name)`	Возвращает значение поля типа `String`.
`final RecordedThread`	`getThread(String name)`	Возвращает значение поля типа `Thread`.
`final <T> T`	`getValue(String name)`	Возвращает значение поля с указанным именем.
`boolean`	`hasField(String name)`	Возвращает `true`, если поле с указанным именем существует, и `false` в противном случае.
`final String`	`toString()`	Возвращает текстовое представление этого объекта.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определённого промежутка реального времени.

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

hasField

public boolean hasField(String name)

Возвращает true, если поле с указанным именем существует, и false в противном случае.

Можно обратиться к вложенному полю с помощью "." (например, "thread.group.parent.name").

Параметры:

name — имя получаемого поля, не null

Возвращает:

true, если поле существует, и false в противном случае

См. также:

getValue

public final <T> T getValue(String name)

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

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

Можно обратиться к вложенному объекту с помощью "." (например, "thread.group.parent.name").

Поле может измениться или быть удалено в одном из будущих выпусков JDK. Рекомендуется перед обращением к полю проверить его наличие.

Пример

if (event.hasField("intValue")) {
    int intValue = event.getValue("intValue");
    System.out.println("Int value: " + intValue);
}

if (event.hasField("objectClass")) {
    RecordedClass clazz = event.getValue("objectClass");
    System.out.println("Class name: " + clazz.getName());
}

if (event.hasField("sampledThread")) {
    RecordedThread sampledThread = event.getValue("sampledThread");
    System.out.println("Sampled thread: " + sampledThread.getJavaName());
}

Параметры типа:

T — тип возвращаемого значения

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение; может быть null

Выбрасывает:

IllegalArgumentException — если поля с именем name не существует

См. также:

getFields

public List<ValueDescriptor> getFields()

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

Возвращает:: поля, не null

getBoolean

public final boolean getBoolean(String name)

Возвращает значение поля типа boolean.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля: true или false

Выбрасывает:

IllegalArgumentException — если поле не существует или не имеет тип boolean

См. также:

getByte

public final byte getByte(String name)

Возвращает значение поля типа byte.

Можно обратиться к вложенному объекту с помощью "." (например, "foo.bar").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля

Выбрасывает:

IllegalArgumentException — если поле не существует или не имеет тип byte

См. также:

getChar

public final char getChar(String name)

Возвращает значение поля типа char.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля в виде char

Выбрасывает:

IllegalArgumentException — если поле не существует или не имеет тип char

См. также:

getShort

public final short getShort(String name)

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

Этот метод можно использовать для следующих типов: short и byte.

Если поле помечено аннотацией @Unsigned и имеет более узкий тип, чем short, значение возвращается как беззнаковое.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля, преобразованное в тип short

Выбрасывает:

IllegalArgumentException — если поле не существует или его значение нельзя преобразовать в тип short с помощью расширяющего преобразования

См. также:

getInt

public final int getInt(String name)

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

Этот метод можно использовать для полей следующих типов: int, short, char и byte.

Если поле помечено аннотацией @Unsigned и имеет более узкий тип, чем int, значение будет возвращено как беззнаковое.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля, преобразованное в тип int

Выбрасывает:

IllegalArgumentException — если поле не существует или его значение нельзя преобразовать в тип int с помощью расширяющего преобразования

См. также:

getFloat

public final float getFloat(String name)

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

Этот метод можно использовать для полей следующих типов: float, long, int, short, char и byte.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля, преобразованное в тип float

Выбрасывает:

IllegalArgumentException — если поле не существует или его значение нельзя преобразовать в тип float с помощью расширяющего преобразования

См. также:

getLong

public final long getLong(String name)

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

Этот метод можно использовать для полей следующих типов: long, int, short, char и byte.

Если поле помечено аннотацией @Unsigned и имеет более узкий тип, чем long, значение будет возвращено как беззнаковое.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля, преобразованное в тип long

Выбрасывает:

IllegalArgumentException — если поле не существует или его значение нельзя преобразовать в тип long с помощью расширяющего преобразования

См. также:

getDouble

public final double getDouble(String name)

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

Этот метод можно использовать для полей следующих типов: double, float, long, int, short, char и byte.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля, преобразованное в тип double

Выбрасывает:

IllegalArgumentException — если поле не существует или его значение нельзя преобразовать в тип double с помощью расширяющего преобразования

См. также:

getString

public final String getString(String name)

Возвращает значение поля типа String.

Можно обратиться к вложенному объекту с помощью "." (например, "foo.bar").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля в виде String; может быть null

Выбрасывает:

IllegalArgumentException — если поле не существует или не имеет тип String

См. также:

getDuration

public final Duration getDuration(String name)

Возвращает значение поля, представляющего временной интервал.

Этот метод можно использовать для полей с аннотацией @Timespan и следующих типов: long, int, short, char и byte.

Если зафиксированное значение события было равно Long.MAX_VALUE, независимо от единицы измерения, заданной с помощью @Timespan, этот метод возвращает ChronoUnit.FOREVER.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

временной интервал в виде Duration, не null

Выбрасывает:

IllegalArgumentException — если поле не существует или его значение нельзя преобразовать в объект Duration

См. также:

getInstant

public final Instant getInstant(String name)

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

Этот метод можно использовать для полей с аннотацией @Timestamp и следующих типов: long, int, short, char и byte.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

временная метка в виде Instant, не null

Выбрасывает:

IllegalArgumentException — если поле не существует или его значение нельзя преобразовать в объект Instant

См. также:

getClass

public final RecordedClass getClass(String name)

Возвращает значение поля типа Class.

Можно обратиться к вложенному объекту с помощью "." (например, "aaa.bbb").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля в виде RecordedClass; может быть null

Выбрасывает:

IllegalArgumentException — если поле не существует или не имеет тип Class

См. также:

getThread

public final RecordedThread getThread(String name)

Возвращает значение поля типа Thread.

Можно обратиться к вложенному объекту с помощью "." (например, "foo.bar").

Параметры:

name — имя получаемого поля, не null

Возвращает:

значение поля в виде объекта RecordedThread; может быть null

Выбрасывает:

IllegalArgumentException — если поле не существует или не имеет тип Thread

См. также:

toString

public final String toString()

Возвращает текстовое представление этого объекта.

Переопределяет:: toString в классе Object
Возвращает:: текстовое описание этого объекта

© 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.