クラスEventSettings

java.lang.Object

jdk.jfr.EventSettings

public abstract class EventSettings extends Object

レコーディングにイベント設定を適用するための簡易クラスです。

メソッド・チェーンを使用して構成されたRecording.enable(String)メソッドを呼び出すと、レコーディングのEventSettingsオブジェクトを取得できます。

次の例は、EventSettingsクラスの使用方法を示しています。

try (Recording r = new Recording()) {
    r.enable("jdk.CPULoad")
     .withPeriod(Duration.ofSeconds(1));
    r.enable("jdk.FileWrite")
     .withoutStackTrace()
     .withThreshold(Duration.ofNanos(10));
    r.start();
    Thread.sleep(10_000);
    r.stop();
    r.dump(Files.createTempFile("recording", ".jfr"));
}

導入されたバージョン:

9

メソッドのサマリー

修飾子と型	メソッド	説明
abstract EventSettings	with(String name, String value)	このイベント設定に関連付けられているイベントの設定値を設定します。
final EventSettings	withoutStackTrace()	このイベント設定に関連付けられているイベントのスタック・トレースを無効にします。
final EventSettings	withoutThreshold()	しきい値が使用されないことを指定します。
final EventSettings	withPeriod(Duration duration)	このイベント設定に関連付けられているイベントの間隔を設定します。
final EventSettings	withStackTrace()	このイベント設定に関連付けられているイベントのスタック・トレースを有効にします。
final EventSettings	withThreshold(Duration duration)	このイベント設定に関連付けられているイベントのしきい値を設定します。

クラスオブジェクトで宣言されたメソッド

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

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

メソッドの詳細

withStackTrace

public final EventSettings withStackTrace()

このイベント設定に関連付けられているイベントのスタック・トレースを有効にします。

with("stackTrace", "true")メソッドの呼出しと同じです。

戻り値:

nullではなく、さらなる構成のためのイベント構成オブジェクト

withoutStackTrace

public final EventSettings withoutStackTrace()

このイベント設定に関連付けられているイベントのスタック・トレースを無効にします。

with("stackTrace", "false")メソッドの呼出しと同じです。

戻り値:

nullではなく、さらなる構成のためのイベント構成オブジェクト

withoutThreshold

public final EventSettings withoutThreshold()

しきい値が使用されないことを指定します。

これは、with("threshold", "0 s")メソッドの呼出しに相当する便利な方法です。

戻り値:

nullではなく、さらなる構成のためのイベント構成オブジェクト

withPeriod

public final EventSettings withPeriod(Duration duration)

このイベント設定に関連付けられているイベントの間隔を設定します。

パラメータ:

duration - nullではなく、期間

戻り値:

nullではなく、さらなる構成のためのイベント構成オブジェクト

withThreshold

public final EventSettings withThreshold(Duration duration)

このイベント設定に関連付けられているイベントのしきい値を設定します。

パラメータ:

duration - 継続時間が使用されない場合は、その時間(null)

戻り値:

nullではなく、さらなる構成のためのイベント構成オブジェクト

with

public abstract EventSettings with(String name, String value)

このイベント設定に関連付けられているイベントの設定値を設定します。

パラメータ:

name - (たとえば、"threshold")設定の名前

value - (たとえば、"20 ms"はnullではありません)を設定する値

戻り値:

nullではなく、さらなる構成のためのイベント構成オブジェクト