Package com.cloudbees.groovy.cps

Class Continuable

java.lang.Object

com.cloudbees.groovy.cps.Continuable

All Implemented Interfaces:

Serializable

public class Continuable
extends Object
implements Serializable

Mutable representation of the program. This is the primary API of the groovy-cps library to the outside.

Author:

Kohsuke Kawaguchi

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final List<Class>	categories	Users of this library must pass (at least) these to GroovyCategorySupport.use(List, Closure) during all operations.
static final StackTraceElement	SEPARATOR_STACK_ELEMENT	The artificial StackTraceElement that appears in the stack trace when the CPS library fixes up the stack trace.

Constructor Summary

Constructors

Constructor	Description
Continuable(Block block)	Creates a Continuable that executes the block of code in a fresh empty environment.
Continuable(Block block, Env e)	Creates a Continuable that executes the block in the specified environment.
Continuable(Continuable src)
Continuable(Next n)
Continuable(groovy.lang.Script cpsTransformedScript)	Takes a Script compiled from CPS-transforming GroovyShell and wraps that into a Continuable.
Continuable(groovy.lang.Script cpsTransformedScript, Env env)	Takes a Script compiled from CPS-transforming GroovyShell and wraps that into a Continuable, in the context of the given Env.
Continuable(groovy.lang.Script cpsTransformedScript, Env env, Continuation k)	Takes a Script compiled from CPS-transforming GroovyShell and wraps that into a Continuable.

Method Summary

Modifier and Type	Method	Description
List<StackTraceElement>	getStackTrace()	Returns the stack trace in the CPS-transformed code that indicates where this Continuable will resume from.
boolean	isResumable()	Checks if this Continuable is pointing at the end of the program which cannot be resumed.
void	printStackTrace(PrintWriter s)	Prints the stack trace into the given writer, much like Throwable.printStackTrace(PrintWriter)
Object	run(Object arg)	Deprecated.
Outcome	run0(Outcome cn)	Resumes this program by either returning the value from suspend(Object) or throwing an exception
Object	runByThrow(Throwable arg)	Deprecated.
static Object	suspend(Object v)	Deprecated.
static Object	suspend(String methodName, Object v)

Methods inherited from class java.lang.Object

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

Field Details

categories

public static final List<Class> categories

Users of this library must pass (at least) these to GroovyCategorySupport.use(List, Closure) during all operations.

SEPARATOR_STACK_ELEMENT

public static final StackTraceElement SEPARATOR_STACK_ELEMENT

The artificial StackTraceElement that appears in the stack trace when the CPS library fixes up the stack trace. This separator separates the regular call stack that tracks the actual call stack JVM executes and the synthesized CPS call stack that CPS-transformed program is logically executing.

Constructor Details

Continuable

public Continuable(Continuable src)

Continuable

public Continuable(Next n)

Continuable

public Continuable(Block block)

Creates a Continuable that executes the block of code in a fresh empty environment.

Continuable

public Continuable(Block block,
 Env e)

Creates a Continuable that executes the block in the specified environment.

Continuable

public Continuable(groovy.lang.Script cpsTransformedScript)

Takes a Script compiled from CPS-transforming GroovyShell and wraps that into a Continuable.

Continuable

public Continuable(groovy.lang.Script cpsTransformedScript,
 Env env)

Takes a Script compiled from CPS-transforming GroovyShell and wraps that into a Continuable, in the context of the given Env. The added 'env' parameter can be used to control the execution flow in case of exceptions, and/or providing custom Invoker

Continuable

public Continuable(groovy.lang.Script cpsTransformedScript,
 Env env,
 Continuation k)

Takes a Script compiled from CPS-transforming GroovyShell and wraps that into a Continuable. The added 'k' parameter can be used to pass the control to somewhere else when the script has finished executing.

Method Details

printStackTrace

public void printStackTrace(PrintWriter s)

Prints the stack trace into the given writer, much like Throwable.printStackTrace(PrintWriter)

run

@Deprecated
public Object run(Object arg)
           throws InvocationTargetException

Deprecated.

Starts/resumes this program until it suspends the next time.

Throws:

InvocationTargetException - if the program threw an exception that it didn't handle by itself.

runByThrow

@Deprecated
public Object runByThrow(Throwable arg)
                  throws InvocationTargetException

Deprecated.

Throws:

InvocationTargetException

run0

public Outcome run0(Outcome cn)

Resumes this program by either returning the value from suspend(Object) or throwing an exception

isResumable

public boolean isResumable()

Checks if this Continuable is pointing at the end of the program which cannot be resumed.

suspend

@Deprecated
public static Object suspend(Object v)

Deprecated.

Called from within CPS transformed program to suspends the execution.

When this method is called, the control goes back to the caller of run(Object), which returns with the argument given to this method.

When the continuable is resumed via run(Object) later, the argument to the run method will become the return value from this method to the CPS-transformed program.

suspend

public static Object suspend(String methodName,
 Object v)

getStackTrace

public List<StackTraceElement> getStackTrace()

Returns the stack trace in the CPS-transformed code that indicates where this Continuable will resume from. If this object represents a yet-started program, an empty list will be returned.