Package org.apache.commons.javaflow.core

Class StackRecorder

java.lang.Object

org.apache.commons.javaflow.core.Stack

org.apache.commons.javaflow.core.StackRecorder

All Implemented Interfaces:

Serializable

public final class StackRecorder
extends Stack

Adds additional behaviors necessary for stack capture/restore on top of Stack.

Author:

Kohsuke Kawaguchi

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
boolean	isCapturing	True, is the continuation freeze the strack trace, and stops the continuation.
boolean	isRestoring	True, if the continuation restores the previous stack trace to the last invocation of suspend().

Fields inherited from class org.apache.commons.javaflow.core.Stack

runnable

Constructor Summary

Constructors

Constructor	Description
StackRecorder(Runnable target)	Creates a new empty StackRecorder that runs the given target.
StackRecorder(Stack parent)	Creates a clone of the given StackRecorder.

Method Summary

Modifier and Type	Method	Description
SuspendResult	execute(ResumeParameter parameter)
static void	exit()
static StackRecorder	get()	Return the continuation, which is associated to the current thread.
Object	getContext()	Access value supplied to resumed method
static Object	suspend(SuspendResult value)

Methods inherited from class java.lang.Object

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

Methods inherited from class org.apache.commons.javaflow.core.Stack

getRunnable, hasDouble, hasFloat, hasInt, hasLong, hasObject, hasReference, isEmpty, isSerializable, popDouble, popFloat, popInt, popLong, popObject, popReference, pushDouble, pushFloat, pushInt, pushLong, pushObject, pushReference, toString

Field Detail

isRestoring

public transient boolean isRestoring

True, if the continuation restores the previous stack trace to the last invocation of suspend().

This field is accessed from the byte code injected into application code, and therefore defining a wrapper get method makes it awkward to step through the user code. That's why this field is public.

isCapturing

public transient boolean isCapturing

True, is the continuation freeze the strack trace, and stops the continuation.

See Also:

isRestoring

Constructor Detail

StackRecorder

public StackRecorder(Runnable target)

Creates a new empty StackRecorder that runs the given target.

Parameters:

target - a target to run

StackRecorder

public StackRecorder(Stack parent)

Creates a clone of the given StackRecorder.

Parameters:

parent - a StackRecorder to clone

Method Detail

suspend

public static Object suspend(SuspendResult value)

execute

public SuspendResult execute(ResumeParameter parameter)

exit

public static void exit()

getContext

public Object getContext()

Access value supplied to resumed method

Returns:

value passed to the resumed method (may be null)

get

public static StackRecorder get()

Return the continuation, which is associated to the current thread.

Returns:

currently associated continuation stack, or null if invoked outside of continuation context