java.lang.Object
jdk.management.jfr.RecordingInfo
public final class RecordingInfo extends Object
Recording
の管理表現。- 導入されたバージョン:
- 9
- 関連項目:
-
メソッドのサマリー
修飾子と型メソッド説明static RecordingInfo
from
(CompositeData cd) 指定されたCompositeData
オブジェクトによって表されるRecordingInfo
を返します。このRecordingInfo
に関連付けられたレコーディングのデータをレコーディング終了時に書き込む先のパスを返します。レコーディングを書き込まない場合はnull
を返します。boolean
JVMが終了したときに、このRecordingInfo
に関連付けられたレコーディングをファイルにダンプするかどうかを返します。long
このRecordingInfo
に関連付けられたレコーディングの必要な期間(秒単位)を返します。期間が設定されていない場合は、0
を返します。long
getId()
このRecordingInfo
に関連付けられたレコーディングの一意のIDを返します。long
ディスクに保持するデータの秒数を返します。永久にデータを保持する場合は0
を返します。long
データ量をバイト単位で測定し、このRecordingInfo
に関連付けられているレコーディングをディスクに保存しておくか、データを無期限に保持する場合は0
を返します。getName()
このRecordingInfo
に関連付けられているレコーディングの名前を返します。このRecordingInfo
に関連付けられたレコーディングの設定を返します。long
getSize()
レコーディングによってレコーディングされたデータ量を返します。このRecordingInfo
に関連付けられています。long
エポックからmsとして測定された、このRecordingInfo
に関連付けられたレコーディングの開始時間を返します。レコーディングが開始していない場合は、null
を返します。getState()
このRecordingInfo
に関連付けられたレコーディングの状態のString
表現を返します。long
このRecordingInfo
に関連付けられたレコーディングの実際のまたは予想される停止時間をエポックからmsで測定します。予想停止時間または実際の停止時間がわからない場合はnull
を返します。レコーディングがまだ停止していない場合にのみ発生します。boolean
isToDisk()
メモリー・バッファが一杯になったときにRecordingInfo
に関連付けられているレコーディングをディスクにフラッシュする必要がある場合はtrue
、そうでない場合はfalse
を返します。toString()
このRecordingInfo
に関連付けられたレコーディングの文字列の説明を返します。
-
メソッドの詳細
-
getName
public String getName()このRecordingInfo
に関連付けられているレコーディングの名前を返します。- 戻り値:
null
ではなく、レコーディング名- 関連項目:
-
getId
public long getId()このRecordingInfo
に関連付けられたレコーディングの一意のIDを返します。- 戻り値:
- レコーディングID
- 関連項目:
-
getDumpOnExit
public boolean getDumpOnExit()JVMが終了したときに、このRecordingInfo
に関連付けられたレコーディングをファイルにダンプするかどうかを返します。- 戻り値:
- 終了時にレコーディングをダンプする必要がある場合は
true
、それ以外の場合はfalse
- 関連項目:
-
getMaxAge
public long getMaxAge()ディスクに保持するデータの秒数を返します。永久にデータを保持する場合は0
を返します。インメモリー・レコーディングは最大経過時間の影響を受けません。
- 戻り値:
- データをディスクに保存する期間(秒単位)
- 関連項目:
-
getMaxSize
public long getMaxSize()データ量をバイト単位で測定し、このRecordingInfo
に関連付けられているレコーディングをディスクに保存しておくか、データを無期限に保持する場合は0
を返します。インメモリー・レコーディングは最大サイズの影響を受けません。
- 戻り値:
- データ量はディスク上にバイト単位で保持する必要があります
- 関連項目:
-
getState
public String getState()このRecordingInfo
に関連付けられたレコーディングの状態のString
表現を返します。有効な戻り値は、
"NEW"
、"DELAYED"
、"STARTING"
、"RUNNING"
、"STOPPING"
、"STOPPED"
および"CLOSED"
です。- 戻り値:
null
ではなく、レコーディング状態- 関連項目:
-
getStartTime
public long getStartTime()エポックからmsとして測定された、このRecordingInfo
に関連付けられたレコーディングの開始時間を返します。レコーディングが開始していない場合は、null
を返します。- 戻り値:
- レコーディングの開始時間、またはレコーディングが開始されていない場合は
null
- 関連項目:
-
getStopTime
public long getStopTime()このRecordingInfo
に関連付けられたレコーディングの実際のまたは予想される停止時間をエポックからmsで測定します。予想停止時間または実際の停止時間がわからない場合はnull
を返します。レコーディングがまだ停止していない場合にのみ発生します。- 戻り値:
- レコーディングの停止時間、またはレコーディングが停止していない場合は
null
。 - 関連項目:
-
getSettings
このRecordingInfo
に関連付けられたレコーディングの設定を返します。- 戻り値:
null
ではなく、レコーディング設定- 関連項目:
-
getDestination
public String getDestination()このRecordingInfo
に関連付けられたレコーディングのデータをレコーディング終了時に書き込む先のパスを返します。レコーディングを書き込まない場合はnull
を返します。- 戻り値:
- 宛先、または設定されていない場合は
null
- 関連項目:
-
toString
public String toString()このRecordingInfo
に関連付けられたレコーディングの文字列の説明を返します。 -
getSize
public long getSize()レコーディングによってレコーディングされたデータ量を返します。このRecordingInfo
に関連付けられています。- 戻り値:
- 記録されたデータ量(バイト単位)
-
isToDisk
public boolean isToDisk()メモリー・バッファが一杯になったときにRecordingInfo
に関連付けられているレコーディングをディスクにフラッシュする必要がある場合はtrue
、そうでない場合はfalse
を返します。- 戻り値:
- レコーディングがディスクの場合は
true
、それ以外の場合はfalse
-
getDuration
public long getDuration()このRecordingInfo
に関連付けられたレコーディングの必要な期間(秒単位)を返します。期間が設定されていない場合は、0
を返します。- 戻り値:
- 必要な期間、または期間が設定されていない場合は
0
- 関連項目:
-
from
public static RecordingInfo from(CompositeData cd) 指定されたCompositeData
オブジェクトによって表されるRecordingInfo
を返します。指定した
CompositeData
には、次のアイテム名およびアイテム・タイプが有効になる必要があります。指定された CompositeData
オブジェクトでサポートされている名前と型名前 型 id Long
name String
state String
dumpOnExit Boolean
size Long
toDisk Boolean
maxAge Long
maxSize Long
startTime Long
stopTime Long
宛先 String
duration Long
settings 要素タイプが SettingDescriptorInfo.from(javax.management.openmbean.CompositeData)
メソッドで指定されたSettingDescriptorInfo
のマップされた型であるjavax.management.openmbean.CompositeData[]
。- パラメータ:
cd
- 返すRecordingInfo
を表すCompositeData
- 戻り値:
cd
で表されるRecordingInfo
、またはcd
がnull
であればnull
- 例外:
IllegalArgumentException
-cd
が有効なRecordingInfo
を表していない場合
-