com.google.template.soy.soytree

Class AbstractCommandNode

java.lang.Object

com.google.template.soy.basetree.AbstractNode

com.google.template.soy.soytree.AbstractSoyNode

com.google.template.soy.soytree.AbstractCommandNode

All Implemented Interfaces:

Node, SoyNode, SoyNode.CommandNode

Direct Known Subclasses:

AbstractParentCommandNode, CallParamNode, CssNode, DebuggerNode, LetNode, XidNode

public abstract class AbstractCommandNode
extends AbstractSoyNode
implements SoyNode.CommandNode

Abstract implementation of a CommandNode.

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

Nested Class Summary

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 inherited from class com.google.template.soy.basetree.AbstractNode

SPACES

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractCommandNode(AbstractCommandNode orig) Copy constructor.
	AbstractCommandNode(int id, String commandName, String commandText)

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).
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.
String	getTagString() Builds a Soy tag string that could be the Soy tag for this node.
String	toSourceString() Builds a Soy source string that could be the source for this node.

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

clone, getId, getParent, getSourceLocation, setId, setSourceLocation, 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

clone, getId, getKind, getParent, getSourceLocation, setId, setSourceLocation

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

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

Constructor Detail

AbstractCommandNode

public AbstractCommandNode(int id,
                           String commandName,
                           String commandText)

Parameters:

id - The id for this node.

commandName - The name of the Soy command.

commandText - The command text, or empty string if none.

AbstractCommandNode

protected AbstractCommandNode(AbstractCommandNode orig)

Copy constructor.

Parameters:

orig - The node to copy.

Method Detail

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.