- java.lang.Object
-
- jdk.jfr.consumer.RecordedObject
-
- 直系の既知のサブクラス:
RecordedClass
,RecordedClassLoader
,RecordedEvent
,RecordedFrame
,RecordedMethod
,RecordedStackTrace
,RecordedThread
,RecordedThreadGroup
public class RecordedObject extends Object
1つ以上のフィールドで構成される複合データ型。このクラスは、ドット
"."
で区切られたString
、たとえば"foo.bar"
を渡すことによって、ネストされたオブジェクトを選択して問合せするメソッドを提供します。 メソッドはネストされたオブジェクトを左から右に評価し、パーツがnull
の場合はNullPointerException
をスローします。- 導入されたバージョン:
- 9
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 boolean
getBoolean(String name)
boolean
型のフィールドの値を返します。byte
getByte(String name)
byte
型のフィールドの値を返します。char
getChar(String name)
char
型のフィールドの値を返します。RecordedClass
getClass(String name)
Class
型のフィールドの値を返します。double
getDouble(String name)
double
型のフィールド、または拡大変換を使用してdouble
型に変換可能な別のプリミティブ型のフィールドの値を返します。Duration
getDuration(String name)
timespanフィールドの値を返します。List<ValueDescriptor>
getFields()
このオブジェクトのフィールドの不変なリストを返します。float
getFloat(String name)
float
型のフィールド、または拡大変換を使用してfloat
型に変換可能な別のプリミティブ型のフィールドの値を返します。Instant
getInstant(String name)
タイムスタンプ・フィールドの値を返します。int
getInt(String name)
int
型のフィールド、または拡大変換を使用してint
型に変換可能な別のプリミティブ型のフィールドの値を返します。long
getLong(String name)
long
型のフィールド、または拡大変換を使用してlong
型に変換可能な別のプリミティブ型のフィールドの値を返します。short
getShort(String name)
short
型のフィールド、または拡大変換を使用してshort
型に変換可能な別のプリミティブ型のフィールドの値を返します。String
getString(String name)
String
型のフィールドの値を返します。RecordedThread
getThread(String name)
Thread
型のフィールドの値を返します。<T> T
getValue(String name)
指定された名前のフィールドの値を返します。boolean
hasField(String name)
指定された名前のフィールドが存在する場合はtrue
を返し、それ以外の場合はfalse
を返します。String
toString()
このオブジェクトのテキスト表現を返します。
-
-
-
メソッドの詳細
-
hasField
public boolean hasField(String name)
指定された名前のフィールドが存在する場合はtrue
を返し、それ以外の場合はfalse
を返します。- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
- フィールドが存在する場合は
true
、それ以外の場合はfalse
。 - 関連項目:
getFields()
-
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.getName()); }
- 型パラメータ:
T
- 戻り値の型- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
- 値を値
null
にすることができます - 例外:
IllegalArgumentException
-name
というフィールドがない場合- 関連項目:
hasField(String)
-
getFields
public List<ValueDescriptor> getFields()
このオブジェクトのフィールドの不変なリストを返します。- 戻り値:
null
ではなく、フィールド
-
getBoolean
public final boolean getBoolean(String name)
boolean
型のフィールドの値を返します。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
- フィールドの値、
true
またはfalse
- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールドのタイプがboolean
ではない場合- 関連項目:
hasField(String)
,getValue(String)
-
getByte
public final byte getByte(String name)
byte
型のフィールドの値を返します。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
- フィールドの値
- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールドのタイプがbyte
ではない場合- 関連項目:
hasField(String)
,getValue(String)
-
getChar
public final char getChar(String name)
char
型のフィールドの値を返します。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
char
としてのフィールドの値- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールドのタイプがchar
ではない場合- 関連項目:
hasField(String)
,getValue(String)
-
getShort
public final short getShort(String name)
short
型のフィールド、または拡大変換を使用してshort
型に変換可能な別のプリミティブ型のフィールドの値を返します。このメソッドは、
short
およびbyte
型のフィールドで使用できます。フィールドに注釈
@Unsigned
があり、short
よりも狭い型の場合、値は符号なしとして返されます。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
short
型に変換されたフィールドの値- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールド値を拡大変換を介してタイプshort
に変換できない場合- 関連項目:
hasField(String)
-
getInt
public final int getInt(String name)
int
型のフィールド、または拡大変換を使用してint
型に変換可能な別のプリミティブ型のフィールドの値を返します。このメソッドは、タイプ
int
、short
、char
、およびbyte
のフィールドで使用できます。フィールドに注釈
@Unsigned
があり、int
よりも狭い型の場合、値は符号なしとして返されます。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
int
型に変換されたフィールドの値- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールド値を拡大変換を介してタイプint
に変換できない場合- 関連項目:
hasField(String)
-
getFloat
public final float getFloat(String name)
float
型のフィールド、または拡大変換を使用してfloat
型に変換可能な別のプリミティブ型のフィールドの値を返します。このメソッドは、タイプ
float
、long
、int
、short
、char
およびbyte
のフィールドで使用できます。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
float
型に変換されたフィールドの値- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールド値を拡大変換を介してタイプfloat
に変換できない場合- 関連項目:
hasField(String)
-
getLong
public final long getLong(String name)
long
型のフィールド、または拡大変換を使用してlong
型に変換可能な別のプリミティブ型のフィールドの値を返します。このメソッドは、タイプ
long
、int
、short
、char
およびbyte
のフィールドで使用できます。フィールドに注釈
@Unsigned
があり、long
よりも狭い型の場合、値は符号なしとして返されます。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
long
型に変換されたフィールドの値- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールド値を拡大変換を介してタイプlong
に変換できない場合- 関連項目:
hasField(String)
-
getDouble
public final double getDouble(String name)
double
型のフィールド、または拡大変換を使用してdouble
型に変換可能な別のプリミティブ型のフィールドの値を返します。このメソッドは、タイプ
double
、float
、long
、int
、short
、char
およびbyte
のフィールドで使用できます。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
double
型に変換されたフィールドの値- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールド値を拡大変換を介してタイプdouble
に変換できない場合- 関連項目:
hasField(String)
-
getString
public final String getString(String name)
String
型のフィールドの値を返します。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
String
としてのフィールドの値は、null
- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールドのタイプがString
ではない場合- 関連項目:
hasField(String)
-
getDuration
public final Duration getDuration(String name)
timespanフィールドの値を返します。このメソッドは、
@Timespan
、およびlong
、int
、short
、char
およびbyte
で注釈が付けられたフィールドで使用できます。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
null
ではなくDuration
で表されるタイム・スパン- 例外:
IllegalArgumentException
- フィールドが存在しないか、フィールド値をDuration
に変換できない場合- 関連項目:
hasField(String)
-
getInstant
public final Instant getInstant(String name)
タイムスタンプ・フィールドの値を返します。このメソッドは、
@Timestamp
、およびlong
、int
、short
、char
およびbyte
で注釈が付けられたフィールドで使用できます。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
null
ではなくInstant
として表されるタイムスタンプ- 例外:
IllegalArgumentException
- フィールドが存在しないか、フィールド値をInstant
に変換できない場合- 関連項目:
hasField(String)
-
getClass
public final RecordedClass getClass(String name)
Class
型のフィールドの値を返します。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
RecordedClass
としてのフィールドの値は、null
- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールドのタイプがClass
ではない場合- 関連項目:
hasField(String)
-
getThread
public final RecordedThread getThread(String name)
Thread
型のフィールドの値を返します。"."
(例えば"foo.bar"
)を使用してネストされたオブジェクトにインデックスを付けることができます。このメソッドの呼び出し側は、将来のJDKバージョンでフィールドが変更されるか、削除される可能性があることを考慮する必要があります。 アクセスを試みる前にフィールドを検証することをお勧めします。
- パラメータ:
name
- 取得するフィールドの名前。null
ではありません。- 戻り値:
RecordedThread
としてのフィールドの値は、null
- 例外:
IllegalArgumentException
- フィールドが存在しない場合、またはフィールドのタイプがThread
ではない場合- 関連項目:
hasField(String)
-
-