com.cloudbees.groovy.cps.impl

Class ProxyEnv

java.lang.Object

com.cloudbees.groovy.cps.impl.ProxyEnv

All Implemented Interfaces:

Env, Serializable

Direct Known Subclasses:

BlockScopeEnv, CaseEnv, TryBlockEnv

public class ProxyEnv
extends Object
implements Env

Author:

Kohsuke Kawaguchi

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Env	parent

Constructor Summary

Constructors

Constructor and Description
ProxyEnv(Env parent)

Method Summary

Methods

Modifier and Type	Method and Description
void	buildStackTraceElements(List<StackTraceElement> stack, int depth) Builds the current call stack information for Throwable.getStackTrace().
Object	closureOwner() Closure or 'this' object that surrounds the currently executing code.
void	declareVariable(Class type, String name)
Continuation	getBreakAddress(String label) If we see a break statement, where should we go?
Continuation	getContinueAddress(String label) If we see a continue statement, where should we go?
Continuation	getExceptionHandler(Class<? extends Throwable> type) Finds the exception handler that catches a Throwable instance of this type.
Invoker	getInvoker() Invoker is typically scoped at the whole execution.
Object	getLocalVariable(String name)
Continuation	getReturnAddress() Where should the return statement return to?
void	setLocalVariable(String name, Object value)

Methods inherited from class java.lang.Object

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

Field Detail

parent

protected final Env parent

Constructor Detail

ProxyEnv

public ProxyEnv(Env parent)

Method Detail

declareVariable

public void declareVariable(Class type,
                   String name)

Specified by:

declareVariable in interface Env

getLocalVariable

public Object getLocalVariable(String name)

Specified by:

getLocalVariable in interface Env

setLocalVariable

public void setLocalVariable(String name,
                    Object value)

Specified by:

setLocalVariable in interface Env

closureOwner

public Object closureOwner()

Description copied from interface: Env

Closure or 'this' object that surrounds the currently executing code. If a new closure instantiation is encountered, this is th object that becomes the owner of that closure.

Specified by:

closureOwner in interface Env

getReturnAddress

public Continuation getReturnAddress()

Description copied from interface: Env

Where should the return statement return to?

Specified by:

getReturnAddress in interface Env

getBreakAddress

public Continuation getBreakAddress(String label)

Description copied from interface: Env

If we see a break statement, where should we go?

Specified by:

getBreakAddress in interface Env

Parameters:

label - Specifies the loop to break from. null for nearest loop.

Returns:

For semantically correct Groovy code, the return value is never null, because not having the matching label is a compile-time error.

getContinueAddress

public Continuation getContinueAddress(String label)

Description copied from interface: Env

If we see a continue statement, where should we go?

Specified by:

getContinueAddress in interface Env

Parameters:

label - Specifies the loop to repeat. null for nearest loop.

Returns:

For semantically correct Groovy code, the return value is never null, because not having the matching label is a compile-time error.

getExceptionHandler

public Continuation getExceptionHandler(Class<? extends Throwable> type)

Description copied from interface: Env

Finds the exception handler that catches a Throwable instance of this type.

Specified by:

getExceptionHandler in interface Env

Returns:

never null. Even if there's no user-specified exception handler, the default 'unhandled exception handler' must be returned.

getInvoker

public Invoker getInvoker()

Description copied from interface: Env

Invoker is typically scoped at the whole execution.

Specified by:

getInvoker in interface Env

Returns:

never null

buildStackTraceElements

public void buildStackTraceElements(List<StackTraceElement> stack,
                           int depth)

Description copied from interface: Env

Builds the current call stack information for Throwable.getStackTrace().

Specified by:

buildStackTraceElements in interface Env

depth - Maximum depth of stack trace to obtain.