com.google.template.soy.soytree

Class CallParamContentNode

java.lang.Object

com.google.template.soy.basetree.AbstractNode

com.google.template.soy.soytree.AbstractSoyNode

com.google.template.soy.soytree.AbstractCommandNode

com.google.template.soy.soytree.CallParamNode

com.google.template.soy.soytree.CallParamContentNode

All Implemented Interfaces:

Node, ParentNode<SoyNode.StandaloneNode>, SoyNode, SoyNode.BlockCommandNode, SoyNode.BlockNode, SoyNode.CommandNode, SoyNode.ParentSoyNode<SoyNode.StandaloneNode>, SoyNode.RenderUnitNode

public final class CallParamContentNode
extends CallParamNode
implements SoyNode.RenderUnitNode

Node representing a 'param' with content.

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	CallParamContentNode.Builder

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

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

SPACES

Method Summary

Modifier and Type	Method and Description
void	addChild(int index, SoyNode.StandaloneNode child) Adds the given child at the given index (shifting existing children if necessary).
void	addChild(SoyNode.StandaloneNode child) Adds the given child.
void	addChildren(int index, List<? extends SoyNode.StandaloneNode> children) Adds the given children at the given index (shifting existing children if necessary).
void	addChildren(List<? extends SoyNode.StandaloneNode> children) Adds the given children.
void	appendSourceStringForChildren(StringBuilder sb) Appends the source strings for all the children to the given StringBuilder.
void	appendTreeStringForChildren(StringBuilder sb, int indent) Appends the tree strings for all the children to the given StringBuilder, at one further indentation level (3 spaces) than the given current indentation level.
void	clearChildren() Clears the list of children.
CallParamContentNode	clone() Copies this node.
SoyNode.StandaloneNode	getChild(int index) Gets the child at the given index.
int	getChildIndex(SoyNode.StandaloneNode child) Finds the index of the given child.
List<SoyNode.StandaloneNode>	getChildren() Gets the list of children.
SanitizedContent.ContentKind	getContentKind() Returns the content kind for strict autoescape, or null if not specified or not applicable.
String	getKey() Returns the param key.
SoyNode.Kind	getKind() Returns this node's kind (corresponding to this node's specific type).
int	numChildren() Gets the number of children.
void	removeChild(int index) Removes the child at the given index.
void	removeChild(SoyNode.StandaloneNode child) Removes the given child.
void	replaceChild(int index, SoyNode.StandaloneNode newChild) Replaces the child at the given index with the given new child.
void	replaceChild(SoyNode.StandaloneNode currChild, SoyNode.StandaloneNode newChild) Replaces the given current child with the given new child.
String	toSourceString() Builds a Soy source string that could be the source for this node.
String	toTreeString(int indent) Builds a string that visually shows the subtree rooted at this node (for debugging).

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

getParent

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

buildTagStringHelper, buildTagStringHelper, getCommandName, getCommandText, getTagString

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

getId, getSourceLocation, setId, setSourceLocation, toString

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

couldHaveSyntaxVersionAtLeast, getNearestAncestor, getSyntaxVersionBound, hasAncestor, maybeSetSyntaxVersionBound, setParent

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.CommandNode

getCommandName, getCommandText, getTagString

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

getId, getParent, getSourceLocation, setId, setSourceLocation

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

couldHaveSyntaxVersionAtLeast, getNearestAncestor, getSyntaxVersionBound, hasAncestor, maybeSetSyntaxVersionBound, setParent

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

getKey

public String getKey()

Description copied from class: CallParamNode

Returns the param key.

Specified by:

getKey in class CallParamNode

getContentKind

@Nullable
public SanitizedContent.ContentKind getContentKind()

Description copied from interface: SoyNode.RenderUnitNode

Returns the content kind for strict autoescape, or null if not specified or not applicable.

Specified by:

getContentKind in interface SoyNode.RenderUnitNode

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

Overrides:

toSourceString in class AbstractCommandNode

Returns:

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

numChildren

public int numChildren()

Description copied from interface: ParentNode

Gets the number of children.

Specified by:

numChildren in interface ParentNode<SoyNode.StandaloneNode>

Returns:

The number of children.

getChild

public SoyNode.StandaloneNode getChild(int index)

Description copied from interface: ParentNode

Gets the child at the given index.

Specified by:

getChild in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

index - The index of the child to get.

Returns:

The child at the given index.

getChildIndex

public int getChildIndex(SoyNode.StandaloneNode child)

Description copied from interface: ParentNode

Finds the index of the given child.

Specified by:

getChildIndex in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

child - The child to find the index of.

Returns:

The index of the given child, or -1 if the given child is not a child of this node.

getChildren

public List<SoyNode.StandaloneNode> getChildren()

Description copied from interface: ParentNode

Gets the list of children. Note: The returned list may not be a copy. Please do not modify the list directly. Instead, use the other methods in this class that are intended for modifying children. Also, if you're iterating over the children list as you're modifying it, then you should first make a copy of the children list to iterate over, in order to avoid ConcurrentModificationException.

Specified by:

getChildren in interface ParentNode<SoyNode.StandaloneNode>

Returns:

The list of children.

addChild

public void addChild(SoyNode.StandaloneNode child)

Description copied from interface: ParentNode

Adds the given child.

Specified by:

addChild in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

child - The child to add.

addChild

public void addChild(int index,
                     SoyNode.StandaloneNode child)

Description copied from interface: ParentNode

Adds the given child at the given index (shifting existing children if necessary).

Specified by:

addChild in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

index - The index to add the child at.

child - The child to add.

removeChild

public void removeChild(int index)

Description copied from interface: ParentNode

Removes the child at the given index.

Specified by:

removeChild in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

index - The index of the child to remove.

removeChild

public void removeChild(SoyNode.StandaloneNode child)

Description copied from interface: ParentNode

Removes the given child.

Specified by:

removeChild in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

child - The child to remove.

replaceChild

public void replaceChild(int index,
                         SoyNode.StandaloneNode newChild)

Description copied from interface: ParentNode

Replaces the child at the given index with the given new child.

Specified by:

replaceChild in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

index - The index of the child to replace.

newChild - The new child.

replaceChild

public void replaceChild(SoyNode.StandaloneNode currChild,
                         SoyNode.StandaloneNode newChild)

Description copied from interface: ParentNode

Replaces the given current child with the given new child.

Specified by:

replaceChild in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

currChild - The current child to be replaced.

newChild - The new child.

clearChildren

public void clearChildren()

Description copied from interface: ParentNode

Clears the list of children.

Specified by:

clearChildren in interface ParentNode<SoyNode.StandaloneNode>

addChildren

public void addChildren(List<? extends SoyNode.StandaloneNode> children)

Description copied from interface: ParentNode

Adds the given children.

Specified by:

addChildren in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

children - The children to add.

addChildren

public void addChildren(int index,
                        List<? extends SoyNode.StandaloneNode> children)

Description copied from interface: ParentNode

Adds the given children at the given index (shifting existing children if necessary).

Specified by:

addChildren in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

index - The index to add the children at.

children - The children to add.

appendSourceStringForChildren

public void appendSourceStringForChildren(StringBuilder sb)

Description copied from interface: ParentNode

Appends the source strings for all the children to the given StringBuilder.

Specified by:

appendSourceStringForChildren in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

sb - The StringBuilder to which to append the children's source strings.

appendTreeStringForChildren

public void appendTreeStringForChildren(StringBuilder sb,
                                        int indent)

Description copied from interface: ParentNode

Appends the tree strings for all the children to the given StringBuilder, at one further indentation level (3 spaces) than the given current indentation level.

Specified by:

appendTreeStringForChildren in interface ParentNode<SoyNode.StandaloneNode>

Parameters:

sb - The StringBuilder to which to append the children's tree strings.

indent - The current indentation level of this parent node.

toTreeString

public String toTreeString(int indent)

Description copied from interface: Node

Builds a string that visually shows the subtree rooted at this node (for debugging). Each line of the string will be indented by the given indentation amount. You should pass an indentation of 0 unless this method is being called as part of building a larger tree string.

Specified by:

toTreeString in interface Node

Overrides:

toTreeString in class AbstractNode

Parameters:

indent - The indentation for each line of the tree string (usually pass 0).

Returns:

A string that visually shows the subtree rooted at this node.

clone

public CallParamContentNode 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.