com.google.template.soy.soytree

Class LetValueNode

java.lang.Object

com.google.template.soy.basetree.AbstractNode

com.google.template.soy.soytree.AbstractSoyNode

com.google.template.soy.soytree.LetNode

com.google.template.soy.soytree.LetValueNode

All Implemented Interfaces:

Node, SoyNode, SoyNode.CommandNode, SoyNode.ExprHolderNode, SoyNode.LocalVarInlineNode, SoyNode.LocalVarNode, SoyNode.StandaloneNode, SoyNode.StatementNode

public final class LetValueNode
extends LetNode
implements SoyNode.ExprHolderNode

Node representing a 'let' statement with a value expression.

Important: Do not use outside of Soy code (treat as superpackage-private).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LetValueNode.Builder Builder for LetValueNode.

Nested classes/interfaces inherited from class com.google.template.soy.soytree.LetNode

LetNode.CommandTextParseResult

Nested classes/interfaces inherited from interface com.google.template.soy.soytree.SoyNode

SoyNode.BlockCommandNode, SoyNode.BlockNode, SoyNode.CommandNode, SoyNode.ConditionalBlockNode, SoyNode.ExprHolderNode, SoyNode.Kind, SoyNode.LocalVarBlockNode, SoyNode.LocalVarInlineNode, SoyNode.LocalVarNode, SoyNode.LoopNode, SoyNode.MsgBlockNode, SoyNode.MsgPlaceholderInitialNode, SoyNode.MsgSubstUnitNode, SoyNode.ParentSoyNode<N extends SoyNode>, SoyNode.RenderUnitNode, SoyNode.SplitLevelTopNode<N extends SoyNode>, SoyNode.StandaloneNode, SoyNode.StatementNode

Field Summary

Fields

Modifier and Type	Field and Description
static SoyError	SELF_ENDING_WITHOUT_VALUE

Fields inherited from class com.google.template.soy.soytree.LetNode

INVALID_COMMAND_TEXT, var

Fields inherited from class com.google.template.soy.basetree.AbstractNode

SPACES

Method Summary

Modifier and Type	Method and Description
protected String	buildTagStringHelper(boolean isSelfEnding) Helper to build the source tag string (usually for testing/debugging).
protected String	buildTagStringHelper(boolean isSelfEnding, boolean isImplicitCommandName) Helper to build the source tag string (usually for testing/debugging).
LetValueNode	clone() Copies this node.
List<ExprUnion>	getAllExprUnions() Returns the list of expressions in this node.
String	getCommandName() May be overridden by subclasses to keep consistent with tree modifications.
String	getCommandText() May be overridden by subclasses to keep consistent with tree modifications.
SoyNode.Kind	getKind() Returns this node's kind (corresponding to this node's specific type).
String	getTagString() Builds a Soy tag string that could be the Soy tag for this node.
ExprRootNode	getValueExpr() Returns the value expression that the variable is set to.
String	getVarName() Return The local variable name (without preceding '$').
String	toSourceString() Builds a Soy source string that could be the source for this node.

Methods inherited from class com.google.template.soy.soytree.LetNode

getParent, getUniqueVarName, getVar, parseCommandTextHelper

Methods inherited from class com.google.template.soy.soytree.AbstractSoyNode

getId, getSourceLocation, setId, toString

Methods inherited from class com.google.template.soy.basetree.AbstractNode

couldHaveSyntaxVersionAtLeast, getNearestAncestor, getSyntaxVersionBound, hasAncestor, maybeSetSyntaxVersionBound, setParent, toTreeString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.template.soy.soytree.SoyNode

getId, getParent, setId

Methods inherited from interface com.google.template.soy.basetree.Node

couldHaveSyntaxVersionAtLeast, getNearestAncestor, getSourceLocation, getSyntaxVersionBound, hasAncestor, maybeSetSyntaxVersionBound, setParent, toSourceString, toTreeString

Field Detail

SELF_ENDING_WITHOUT_VALUE

public static final SoyError SELF_ENDING_WITHOUT_VALUE

Method Detail

getKind

public SoyNode.Kind getKind()

Description copied from interface: SoyNode

Returns this node's kind (corresponding to this node's specific type).

Specified by:

getKind in interface SoyNode

getVarName

public final String getVarName()

Return The local variable name (without preceding '$').

Specified by:

getVarName in interface SoyNode.LocalVarNode

getValueExpr

public ExprRootNode getValueExpr()

Returns the value expression that the variable is set to.

getAllExprUnions

public List<ExprUnion> getAllExprUnions()

Description copied from interface: SoyNode.ExprHolderNode

Returns the list of expressions in this node.

Specified by:

getAllExprUnions in interface SoyNode.ExprHolderNode

clone

public LetValueNode clone()

Description copied from interface: Node

Copies this node. The clone's parent pointer is set to null.

All clone() overrides should follow this contract:

• only leaf classes (in the class hierarchy) should have non-abstract clone methods
• all leaf classes should be final
• all leaf copy constructors should be private
• all clone methods should look exactly like:

  
      {@literal @}Override public T clone() {
        return new T(this);
      }
   

• all non-leaf copy constructors should be protected

NOTE: this means we do not ultimately delegate to Object.clone(), ever.

TODO(lukes): The usecases for a clone method are few and far between. Making the AST nodes immutable (or at least unmodifiable) would be preferable to maintaining our clone() methods.

Specified by:

clone in interface Node

Specified by:

clone in interface SoyNode

Specified by:

clone in class AbstractSoyNode

Returns:

A clone of this code.

getCommandName

public String getCommandName()

May be overridden by subclasses to keep consistent with tree modifications.

Specified by:

getCommandName in interface SoyNode.CommandNode

getCommandText

public String getCommandText()

May be overridden by subclasses to keep consistent with tree modifications.

Specified by:

getCommandText in interface SoyNode.CommandNode

getTagString

public String getTagString()

Description copied from interface: SoyNode.CommandNode

Builds a Soy tag string that could be the Soy tag for this node. Note that this may not necessarily be the actual original Soy tag, but a (sort of) canonical equivalent.

Specified by:

getTagString in interface SoyNode.CommandNode

Returns:

A Soy tag string that could be the Soy tag for this node.

buildTagStringHelper

protected String buildTagStringHelper(boolean isSelfEnding)

Helper to build the source tag string (usually for testing/debugging). Handles most cases, including (a) with or without tag text, (b) self-ending tags, or (c) tags whose text contains a brace character.

Parameters:

isSelfEnding - Whether the tag is self-ending, i.e. { ... /}.

Returns:

The source tag string, possibly with some differences in spacing.

buildTagStringHelper

protected String buildTagStringHelper(boolean isSelfEnding,
                                      boolean isImplicitCommandName)

Helper to build the source tag string (usually for testing/debugging). Handles all cases, including (a) with or without tag text, (b) self-ending tags, (c) tags whose text contains a brace character, or (d) implicit 'print' tags.

Parameters:

isSelfEnding - Whether the tag is self-ending, i.e. { ... /}.

isImplicitCommandName - Whether the command name is implicit, e.g. a 'print' tag without the explicit 'print'.

Returns:

The source tag string, possibly with some differences in spacing.

toSourceString

public String toSourceString()

Description copied from interface: Node

Builds a Soy source string that could be the source for this node. Note that this is not the actual original source string, but a (sort of) canonical equivalent. Note: Some nodes do not have a direct mapping to Soy source (such as nodes created during some optimization passes). Thus this method may not always be supported.

Specified by:

toSourceString in interface Node

Returns:

A Soy string that could be the source for this node.