Класс 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)`	Возвращает значение поля типа timespan.
`List<ValueDescriptor>`	`getFields()`	Возвращает неизменяемый список полей для этого объекта.
`final float`	`getFloat(String name)`	Возвращает значение поля типа `float` или другого примитивного типа, преобразуемого к типу `float` с помощью расширяющего преобразования.
`final Instant`	`getInstant(String name)`	Возвращает значение поля типа timestamp.
`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()`	Возвращает текстовое представление этого объекта.

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

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

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

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").

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

Parameters:

name - имя поля для получения, не null

Returns:

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

Throws:

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

See Also:

getString

public final String getString(String name)

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

Возможен доступ к вложенному объекту с использованием "." (например, "foo.bar").

Parameters:

name - имя поля для получения, не null

Returns:

значение поля как String, может быть null

Throws:

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

See Also:

getDuration

public final Duration getDuration(String name)

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

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

Если значение подтверждённого события было Long.MAX_VALUE, независимо от единицы измерения, установленной @Timespan, этот метод возвращает ChronoUnit.FOREVER.

Возможен доступ к вложенному объекту с использованием "." (например, "aaa.bbb").

Parameters:

name - имя поля для получения, не null

Returns:

интервал времени, представленный как Duration, не null

Throws:

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

See Also:

getInstant

public final Instant getInstant(String name)

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

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

Возможен доступ к вложенному объекту с использованием "." (например, "aaa.bbb").

Parameters:

name - имя поля для получения, не null

Returns:

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

Throws:

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

See Also:

getClass

public final RecordedClass getClass(String name)

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

Возможен доступ к вложенному объекту с использованием "." (например, "aaa.bbb").

Parameters:

name - имя поля для получения, не null

Returns:

значение поля как RecordedClass, может быть null

Throws:

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

See Also:

getThread

public final RecordedThread getThread(String name)

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

Возможен доступ к вложенному объекту с использованием "." (например, "foo.bar").

Parameters:

name - имя поля для получения, не null

Returns:

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

Throws:

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

See Also:

toString

public final String toString()

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

Overrides:: toString в классе Object
Returns:: текстовое описание этого объекта

© 1993, 2023, 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/21/docs/api/jdk.jfr/jdk/jfr/consumer/RecordedObject.html