Modifier and Type	Class and Description
public static enum	Continuation.Pinned Reason for pinning
public static enum	Continuation.PreemptStatus Preemption attempt result

Modifier and Type	Field and Description
private Continuation	child
private boolean	done
private static final JavaLangAccess	JLA
private volatile boolean	mounted
private static final long	MOUNTED_OFFSET
private Continuation	parent
private boolean	preempted
private static final boolean	PRESERVE_SCOPED_VALUE_CACHE
private final ContinuationScope	scope
private Object[]	scopedValueCache
private StackChunk	tail
private final Runnable	target
private static final Unsafe	U
private Object	yieldInfo

Access	Constructor and Description
public	Continuation(ContinuationScope the continuation's scope, used in yield scope, Runnable the continuation's body target) Constructs a continuation

Method Summary

Modifier and Type	Method and Description
private boolean	compareAndSetMounted(boolean expectedValue, boolean newValue)
private static Thread	currentCarrierThread()
private static native int	doYield()
private void	dump()
private static void	enter(Continuation c, boolean isContinue)
private void	enter0()
private static native void	enterSpecial(Continuation c, boolean isContinue, boolean isVirtualThread)
private boolean	fence()
private void	finish()
public static Continuation	Returns: the continuation getCurrentContinuation(ContinuationScope the scope scope) Returns the current innermost continuation with the given scope
public Continuation	getParent()
public ContinuationScope	getScope()
public StackTraceElement[]	Returns: the stack trace getStackTrace() Obtains a stack trace for this unmounted continuation
private String	id()
private Continuation	innermost()
public boolean	Returns: whether this continuation is completed isDone() Tests whether this continuation is completed
private boolean	isEmpty()
private static boolean	isEmptyOrTrue(String property)
public static boolean	Returns: true if we're in the give scope and are pinned; `false otherwise` isPinned(ContinuationScope the continuation scope scope) Tests whether the given scope is pinned.
private static native int	isPinned0(ContinuationScope scope)
public boolean	Returns: whether this unmounted continuation was unmounted by forceful preemption isPreempted() Tests whether this unmounted continuation was unmounted by forceful preemption (a successful tryPreempt)
private boolean	isStarted()
private void	mount()
protected void	onContinue() Called when the continuation continues
protected void	onPinned(Continuation.Pinned the reason for pinning reason) Called when suspending if the continuation is pinned
private void	onPinned0(int reason)
public static native void	pin() Pins the current continuation (enters a critical section).
private static Continuation.Pinned	pinnedReason(int reason)
private void	postYieldCleanup()
private static native void	registerNatives()
public final void	run() Mounts and runs the continuation body.
private void	setMounted(boolean newValue)
public StackWalker	Returns: a new StackWalker stackWalker() Creates a StackWalker for this continuation
public StackWalker	Returns: a new StackWalker stackWalker(Set<StackWalker.Option> the StackWalker's configuration options options) Creates a StackWalker for this continuation
public StackWalker	Returns: a new StackWalker stackWalker(Set<StackWalker.Option> the StackWalker's configuration options options, ContinuationScope the delimiting continuation scope for the stack scope) Creates a StackWalker for this continuation and enclosing ones up to the given scope
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
public Continuation.PreemptStatus	Returns: the result of the attempt tryPreempt(Thread the thread on which to forcefully preempt this continuation thread) Tries to forcefully preempt this continuation if it is currently mounted on the given thread Subclasses may throw an `UnsupportedOperationException`, but this does not prevent the continuation from being preempted on a parent scope.
private void	unmount()
public static native void	unpin() Unpins the current continuation (exits a critical section).
public static <R> R	wrapWalk(Continuation inner, ContinuationScope scope, Supplier<R> walk)
public static boolean	Returns: `true` for success; `false` for failure yield(ContinuationScope The `ContinuationScope` to suspend scope) Suspends the current continuations up to the given scope
private boolean	yield0(ContinuationScope scope, Continuation child)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

child	back to summary
private Continuation child

done	back to summary
private boolean done

JLA	back to summary
private static final JavaLangAccess JLA

mounted	back to summary
private volatile boolean mounted

MOUNTED_OFFSET	back to summary
private static final long MOUNTED_OFFSET

parent	back to summary
private Continuation parent

preempted	back to summary
private boolean preempted

PRESERVE_SCOPED_VALUE_CACHE	back to summary
private static final boolean PRESERVE_SCOPED_VALUE_CACHE

scope	back to summary
private final ContinuationScope scope

scopedValueCache	back to summary
private Object[] scopedValueCache

tail	back to summary
private StackChunk tail

target	back to summary
private final Runnable target

U	back to summary
private static final Unsafe U

yieldInfo	back to summary
private Object yieldInfo

Constructor Detail

Continuation	back to summary
public Continuation(ContinuationScope scope, Runnable target) Constructs a continuation Parameters scope:ContinuationScope the continuation's scope, used in yield target:Runnable the continuation's body

Continuation

back to summary

public Continuation(ContinuationScope scope, Runnable target)

Constructs a continuation

Parameters

scope:ContinuationScope: the continuation's scope, used in yield
target:Runnable: the continuation's body

Method Detail

compareAndSetMounted	back to summary
private boolean compareAndSetMounted(boolean expectedValue, boolean newValue)

currentCarrierThread	back to summary
private static Thread currentCarrierThread()

doYield	back to summary
private static native int doYield() Annotations @IntrinsicCandidate

dump	back to summary
private void dump()

enter	back to summary
private static void enter(Continuation c, boolean isContinue) Annotations @Hidden @DontInline @IntrinsicCandidate @JvmtiHideEvents

enter0	back to summary
private void enter0() Annotations @Hidden @JvmtiHideEvents

enterSpecial	back to summary
private static native void enterSpecial(Continuation c, boolean isContinue, boolean isVirtualThread) Annotations @IntrinsicCandidate

fence	back to summary
private boolean fence()

finish	back to summary
private void finish()

getCurrentContinuation	back to summary
public static Continuation getCurrentContinuation(ContinuationScope scope) Returns the current innermost continuation with the given scope Parameters scope:ContinuationScope the scope Returns:Continuation the continuation

getCurrentContinuation

back to summary

public static Continuation getCurrentContinuation(ContinuationScope scope)

Returns the current innermost continuation with the given scope

Parameters

scope:ContinuationScope: the scope

Returns:Continuation

the continuation

getParent	back to summary
public Continuation getParent()

getScope	back to summary
public ContinuationScope getScope()

getStackTrace	back to summary
public StackTraceElement[] getStackTrace() Obtains a stack trace for this unmounted continuation Returns:StackTraceElement[] the stack trace Exceptions IllegalStateException: if the continuation is mounted

getStackTrace

back to summary

public StackTraceElement[] getStackTrace()

Obtains a stack trace for this unmounted continuation

Returns:StackTraceElement[]

the stack trace

Exceptions

IllegalStateException:: if the continuation is mounted

id	back to summary
private String id()

innermost	back to summary
private Continuation innermost()

isDone	back to summary
public boolean isDone() Tests whether this continuation is completed Returns:boolean whether this continuation is completed

isDone

back to summary

public boolean isDone()

Tests whether this continuation is completed

Returns:boolean: whether this continuation is completed

isEmpty	back to summary
private boolean isEmpty()

isEmptyOrTrue	back to summary
private static boolean isEmptyOrTrue(String property)

isPinned back to summary

isPinned	back to summary
public static boolean isPinned(ContinuationScope scope) Tests whether the given scope is pinned. This method is slow. Parameters scope:ContinuationScope the continuation scope Returns:boolean true if we're in the give scope and are pinned; `false otherwise`

public static boolean isPinned(ContinuationScope scope)

Tests whether the given scope is pinned. This method is slow.

Parameters

scope:ContinuationScope: the continuation scope

Returns:boolean

true if we're in the give scope and are pinned; false otherwise

isPinned0	back to summary
private static native int isPinned0(ContinuationScope scope)

isPreempted	back to summary
public boolean isPreempted() Tests whether this unmounted continuation was unmounted by forceful preemption (a successful tryPreempt) Returns:boolean whether this unmounted continuation was unmounted by forceful preemption

isPreempted

back to summary

public boolean isPreempted()

Tests whether this unmounted continuation was unmounted by forceful preemption (a successful tryPreempt)

Returns:boolean: whether this unmounted continuation was unmounted by forceful preemption

isStarted	back to summary
private boolean isStarted()

mount	back to summary
private void mount()

onContinue	back to summary
protected void onContinue() Called when the continuation continues

onPinned	back to summary
protected void onPinned(Continuation.Pinned reason) Called when suspending if the continuation is pinned Parameters reason:Continuation.Pinned the reason for pinning

onPinned

back to summary

protected void onPinned(Continuation.Pinned reason)

Called when suspending if the continuation is pinned

Parameters

reason:Continuation.Pinned: the reason for pinning

onPinned0	back to summary
private void onPinned0(int reason)

pin	back to summary
public static native void pin() Pins the current continuation (enters a critical section). This increments an internal semaphore that, when greater than 0, pins the continuation. Annotations @IntrinsicCandidate

back to summary

public static native void pin()

Pins the current continuation (enters a critical section). This increments an internal semaphore that, when greater than 0, pins the continuation.

Annotations

@IntrinsicCandidate

pinnedReason	back to summary
private static Continuation.Pinned pinnedReason(int reason)

postYieldCleanup	back to summary
private void postYieldCleanup()

registerNatives	back to summary
private static native void registerNatives()

run	back to summary
public final void run() Mounts and runs the continuation body. If suspended, continues it from the last suspend point.

setMounted	back to summary
private void setMounted(boolean newValue)

stackWalker

back to summary

public StackWalker stackWalker()

Creates a StackWalker for this continuation

Returns:StackWalker: a new StackWalker

stackWalker

back to summary

public StackWalker stackWalker(Set<StackWalker.Option> options)

Creates a StackWalker for this continuation

Parameters

options:Set<StackWalker.Option>: the StackWalker's configuration options

Returns:StackWalker

a new StackWalker

stackWalker

back to summary

public StackWalker stackWalker(Set<StackWalker.Option> options, ContinuationScope scope)

Creates a StackWalker for this continuation and enclosing ones up to the given scope

Parameters

options:Set<StackWalker.Option>: the StackWalker's configuration options
scope:ContinuationScope: the delimiting continuation scope for the stack

Returns:StackWalker

a new StackWalker

toString back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Annotations

@Override

tryPreempt back to summary

public Continuation.PreemptStatus tryPreempt(Thread thread)

Tries to forcefully preempt this continuation if it is currently mounted on the given thread Subclasses may throw an UnsupportedOperationException, but this does not prevent the continuation from being preempted on a parent scope.

Parameters

thread:Thread: the thread on which to forcefully preempt this continuation

Returns:Continuation.PreemptStatus

the result of the attempt

Exceptions

UnsupportedOperationException:: if this continuation does not support preemption

unmount	back to summary
private void unmount()

unpin back to summary

public static native void unpin()

Unpins the current continuation (exits a critical section). This decrements an internal semaphore that, when equal 0, unpins the current continuation if pinned with pin().

Annotations

@IntrinsicCandidate

wrapWalk	back to summary
public static <R> R wrapWalk(Continuation inner, ContinuationScope scope, Supplier<R> walk)

yield back to summary

public static boolean yield(ContinuationScope scope)

Suspends the current continuations up to the given scope

Parameters

scope:ContinuationScope: The ContinuationScope to suspend

Returns:boolean

true for success; false for failure

Annotations

@Hidden
@JvmtiHideEvents

Exceptions

IllegalStateException:: if not currently in the given scope,

yield0	back to summary
private boolean yield0(ContinuationScope scope, Continuation child) Annotations @Hidden @JvmtiHideEvents

jdk.internal.vm back to summary

public final Enum Continuation.Pinned

Class Inheritance

extends Enum<Continuation.Pinned>

java.lang.Object
java.lang.Enum
jdk.internal.vm.Continuation.Pinned

Reason for pinning

Field Summary

Modifier and Type	Field and Description
public static final Continuation.Pinned	CRITICAL_SECTION In critical section
public static final Continuation.Pinned	EXCEPTION Exception (OOME/SOE)
public static final Continuation.Pinned	NATIVE Native frame on stack

Constructor Summary

Access	Constructor and Description
private	Pinned()

Method Summary

Modifier and Type	Method and Description
public static Continuation.Pinned	valueOf(String name)
public static Continuation.Pinned[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

CRITICAL_SECTION	back to summary
public static final Continuation.Pinned CRITICAL_SECTION In critical section

EXCEPTION	back to summary
public static final Continuation.Pinned EXCEPTION Exception (OOME/SOE)

NATIVE	back to summary
public static final Continuation.Pinned NATIVE Native frame on stack

Constructor Detail

Pinned	back to summary
private Pinned()

Method Detail

valueOf	back to summary
public static Continuation.Pinned valueOf(String name)

values	back to summary
public static Continuation.Pinned[] values()

jdk.internal.vm back to summary

public final Enum Continuation.PreemptStatus

Class Inheritance

extends Enum<Continuation.PreemptStatus>

java.lang.Object
java.lang.Enum
jdk.internal.vm.Continuation.PreemptStatus

Preemption attempt result

Field Summary

Modifier and Type	Field and Description
public static final Continuation.PreemptStatus	PERM_FAIL_NOT_MOUNTED Permanent failure: continuation not mounted on the thread
public static final Continuation.PreemptStatus	PERM_FAIL_UNSUPPORTED Permanent failure
public static final Continuation.PreemptStatus	PERM_FAIL_YIELDING Permanent failure: continuation already yielding
pack-priv final Continuation.Pinned	pinned
public static final Continuation.PreemptStatus	SUCCESS Success
public static final Continuation.PreemptStatus	TRANSIENT_FAIL_PINNED_CRITICAL_SECTION Transient failure: continuation pinned due to a held CS
public static final Continuation.PreemptStatus	TRANSIENT_FAIL_PINNED_NATIVE Transient failure: continuation pinned due to native frame

Constructor Summary

Access	Constructor and Description
private	PreemptStatus(Continuation.Pinned reason)

Method Summary

Modifier and Type	Method and Description
public Continuation.Pinned	Returns: whether or not the continuation is pinned pinned() Whether or not the continuation is pinned.
public static Continuation.PreemptStatus	valueOf(String name)
public static Continuation.PreemptStatus[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

PERM_FAIL_NOT_MOUNTED	back to summary
public static final Continuation.PreemptStatus PERM_FAIL_NOT_MOUNTED Permanent failure: continuation not mounted on the thread

PERM_FAIL_UNSUPPORTED	back to summary
public static final Continuation.PreemptStatus PERM_FAIL_UNSUPPORTED Permanent failure

PERM_FAIL_YIELDING	back to summary
public static final Continuation.PreemptStatus PERM_FAIL_YIELDING Permanent failure: continuation already yielding

pinned	back to summary
pack-priv final Continuation.Pinned pinned

SUCCESS	back to summary
public static final Continuation.PreemptStatus SUCCESS Success

TRANSIENT_FAIL_PINNED_CRITICAL_SECTION	back to summary
public static final Continuation.PreemptStatus TRANSIENT_FAIL_PINNED_CRITICAL_SECTION Transient failure: continuation pinned due to a held CS

TRANSIENT_FAIL_PINNED_NATIVE	back to summary
public static final Continuation.PreemptStatus TRANSIENT_FAIL_PINNED_NATIVE Transient failure: continuation pinned due to native frame

Constructor Detail

PreemptStatus	back to summary
private PreemptStatus(Continuation.Pinned reason)

Method Detail

pinned

back to summary

public Continuation.Pinned pinned()

Whether or not the continuation is pinned.

Returns:Continuation.Pinned: whether or not the continuation is pinned

valueOf	back to summary
public static Continuation.PreemptStatus valueOf(String name)

values	back to summary
public static Continuation.PreemptStatus[] values()

public Class Continuation

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum Continuation.Pinned

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum Continuation.PreemptStatus

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail