[Java] Class CompileStack

public class CompileStack
extends Object

Method Detail

public def CompileStack(WriterController wc)

public void addExceptionBlock(org.objectweb.asm.Label start, org.objectweb.asm.Label end, org.objectweb.asm.Label goal, String sig)

public void applyBlockRecorder()

public void applyFinallyBlocks(org.objectweb.asm.Label label, boolean isBreakLabel)

public void clear()

Clears the state of the class. This method should be called after a MethodNode is visited. Note that a call to init will fail if clear is not called before

public boolean containsVariable(String name)

Parameters:

name - the name of the variable of interest

Returns:

true if a variable is already defined

public org.objectweb.asm.Label createLocalLabel(String name)

creates a new named label

public int defineTemporaryVariable(Variable var, boolean store)

creates a temporary variable.

Parameters:

var - defines type and name

store - defines if the toplevel argument of the stack should be stored

Returns:

the index used for this temporary variable

public int defineTemporaryVariable(String name, boolean store)

creates a temporary variable.

Parameters:

name - defines type and name

store - defines if the top-level argument of the stack should be stored

Returns:

the index used for this temporary variable

public int defineTemporaryVariable(String name, ClassNode node, boolean store)

creates a temporary variable.

Parameters:

name - defines the name

node - defines the node

store - defines if the top-level argument of the stack should be stored

Returns:

the index used for this temporary variable

public BytecodeVariable defineVariable(Variable v, boolean initFromStack)

Defines a new Variable using an AST variable.

Parameters:

initFromStack - if true the last element of the stack will be used to initialize the new variable. If false null will be used.

public BytecodeVariable defineVariable(Variable v, ClassNode variableType, boolean initFromStack)

public org.objectweb.asm.Label getBreakLabel()

public org.objectweb.asm.Label getContinueLabel()

public org.objectweb.asm.Label getLabel(String name)

Returns the label for the given name

public org.objectweb.asm.Label getNamedBreakLabel(String name)

Used for break foo inside a loop to end the execution of the marked loop. This method will return the break label of the loop if there is one found for the name. If not, the current break label is returned.

public org.objectweb.asm.Label getNamedContinueLabel(String name)

Used for continue foo inside a loop to continue the execution of the marked loop. This method will return the break label of the loop if there is one found for the name. If not, getLabel is used.

public VariableScope getScope()

public BytecodeVariable getVariable(String variableName)

public BytecodeVariable getVariable(String variableName, boolean mustExist)

Returns a normal variable.

If mustExist is true and the normal variable doesn't exist, then this method will throw a GroovyBugError. It is not the intention of this method to let this happen! And the exception should not be used for flow control - it is just acting as an assertion. If the exception is thrown then it indicates a bug in the class using CompileStack. This method can also not be used to return a temporary variable. Temporary variables are not normal variables.

Parameters:

variableName - name of the variable

mustExist - throw exception if variable does not exist

Returns:

the normal variable or null if not found (and mustExist not true)

public boolean hasBlockRecorder()

public void init(VariableScope el, Parameter[] parameters)

initializes this class for a MethodNode. This method will automatically define variables for the method parameters and will create references if needed. The created variables can be accessed by calling getVariable().

public boolean isImplicitThis()

public boolean isInSpecialConstructorCall()

public boolean isLHS()

public void pop()

public void popBlockRecorderVisit(CompileStack.BlockRecorder finallyBlock)

public void popImplicitThis()

public void popLHS()

public void pushBlockRecorder(CompileStack.BlockRecorder recorder)

public void pushBlockRecorderVisit(CompileStack.BlockRecorder finallyBlock)

public void pushBooleanExpression()

because a boolean Expression may not be evaluated completely it is important to keep the registers clean

public void pushImplicitThis(boolean implicitThis)

public void pushInSpecialConstructorCall()

public void pushLHS(boolean lhs)

public void pushLoop(VariableScope el, String labelName)

Should be called when descending into a loop that defines also a scope. Calls pushVariableScope and prepares labels for a loop structure. Creates a element for the state stack so pop has to be called later, TODO:

Deprecate:

public void pushLoop(VariableScope el, List<String> labelNames)

Should be called when descending into a loop that defines also a scope. Calls pushVariableScope and prepares labels for a loop structure. Creates a element for the state stack so pop has to be called later

public void pushLoop(String labelName)

Should be called when descending into a loop that does not define a scope. Creates a element for the state stack so pop has to be called later, TODO:

Deprecate:

public void pushLoop(List<String> labelNames)

Should be called when descending into a loop that does not define a scope. Creates a element for the state stack so pop has to be called later

public void pushState()

public org.objectweb.asm.Label pushSwitch()

Creates a new break label and a element for the state stack so pop has to be called later

public void pushVariableScope(VariableScope el)

Causes the state-stack to add an element and sets the given scope as new current variable scope. Creates a element for the state stack so pop has to be called later

public void removeVar(int tempIndex)

public void writeExceptionTable(CompileStack.BlockRecorder block, org.objectweb.asm.Label goal, String sig)