com.google.template.soy.jbcsrc.restricted

Class Statement

java.lang.Object

com.google.template.soy.jbcsrc.restricted.BytecodeProducer

com.google.template.soy.jbcsrc.restricted.Statement

public abstract class Statement
extends BytecodeProducer

A statement models a section of code. Unlike expressions, statements may have side effects. For example, the Soy code {'foo'} could be implemented as a statement that writes to an output stream.

The generated code should satisfy the invariant that the runtime stack and local variables are are unchanged by the generated code (i.e. the frame map at the start of the statement is identical to the frame map at the end of the statement).

Field Summary

Fields

Modifier and Type	Field and Description
static Statement	NULL_STATEMENT
static Statement	RETURN

Fields inherited from class com.google.template.soy.jbcsrc.restricted.BytecodeProducer

location

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Statement()
protected	Statement(SourceLocation location)

Method Summary

Modifier and Type	Method and Description
static Statement	concat(Iterable<? extends Statement> statements) Returns a statement that concatenates all the provided statements.
static Statement	concat(Statement... statements) Returns a statement that concatenates all the provided statements.
Statement	labelStart(org.objectweb.asm.Label label) Returns a new statement identical to this one but with the given label applied at the start of the statement.
static Statement	returnExpression(Expression expression) Generates a statement that returns the value produced by the given expression.
static Statement	throwExpression(Expression expression) Generates a statement that throws the throwable produced by the given expression.
String	toString()
Statement	withSourceLocation(SourceLocation location) Returns a new Statement with the source location attached.
void	writeIOExceptionMethod(int access, org.objectweb.asm.commons.Method method, org.objectweb.asm.ClassVisitor visitor) Writes this statement to the ClassVisitor as a method.
void	writeMethod(int access, org.objectweb.asm.commons.Method method, org.objectweb.asm.ClassVisitor visitor) Writes this statement to the ClassVisitor as a method.

Methods inherited from class com.google.template.soy.jbcsrc.restricted.BytecodeProducer

doGen, gen, trace

Methods inherited from class java.lang.Object

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

Field Detail

NULL_STATEMENT

public static final Statement NULL_STATEMENT

RETURN

public static final Statement RETURN

Constructor Detail

Statement

protected Statement()

Statement

protected Statement(SourceLocation location)

Method Detail

returnExpression

public static Statement returnExpression(Expression expression)

Generates a statement that returns the value produced by the given expression.

This does not validate that the return type is appropriate. It is our callers responsibility to do that.

throwExpression

public static Statement throwExpression(Expression expression)

Generates a statement that throws the throwable produced by the given expression.

This does not validate that the throwable is compatible with the methods throws clause.

concat

public static Statement concat(Statement... statements)

Returns a statement that concatenates all the provided statements.

concat

public static Statement concat(Iterable<? extends Statement> statements)

Returns a statement that concatenates all the provided statements.

writeMethod

public final void writeMethod(int access,
                              org.objectweb.asm.commons.Method method,
                              org.objectweb.asm.ClassVisitor visitor)

Writes this statement to the ClassVisitor as a method.

Parameters:

access - The access modifiers of the method

method - The method signature

visitor - The class visitor to write it to

writeIOExceptionMethod

public final void writeIOExceptionMethod(int access,
                                         org.objectweb.asm.commons.Method method,
                                         org.objectweb.asm.ClassVisitor visitor)

Writes this statement to the ClassVisitor as a method.

Parameters:

access - The access modifiers of the method

method - The method signature

visitor - The class visitor to write it to

labelStart

public final Statement labelStart(org.objectweb.asm.Label label)

Returns a new statement identical to this one but with the given label applied at the start of the statement.

withSourceLocation

public final Statement withSourceLocation(SourceLocation location)

Returns a new Statement with the source location attached.

toString

public String toString()

Overrides:

toString in class Object