Class ASTReference
- java.lang.Object
-
- org.apache.velocity.runtime.parser.node.SimpleNode
-
- org.apache.velocity.runtime.parser.node.ASTReference
-
- All Implemented Interfaces:
Node
,Renderable
public class ASTReference extends SimpleNode
This class is responsible for handling the references in VTL ($foo). Please look at the Parser.jjt file which is what controls the generation of this class.- Version:
- $Id: ASTReference.java 832302 2009-11-03 05:32:31Z wglass $
-
-
Field Summary
Fields Modifier and Type Field Description private ASTIndex
astIndex
non null Indicates if we are setting an index reference e.g, $foo[2], which basically means that the last syntax of the reference are brackets.private boolean
computableReference
private boolean
escaped
private java.lang.String
escPrefix
private static int
FORMAL_REFERENCE
private java.lang.String
identifier
private java.lang.String
literal
private boolean
logOnNull
private java.lang.String
morePrefix
private static int
NORMAL_REFERENCE
private java.lang.String
nullString
private int
numChildren
private static int
QUIET_REFERENCE
private int
referenceType
private java.lang.String
rootString
private static int
RUNT
boolean
strictEscape
Indicates if we are using modified escape behavior in strict mode.boolean
strictRef
Indicates if we are running in strict reference mode.boolean
toStringNullCheck
Indicates if toString() should be called during condition evaluation just to ensure it does not return null.protected Info
uberInfo
-
Constructor Summary
Constructors Constructor Description ASTReference(int id)
ASTReference(Parser p, int id)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
evaluate(InternalContextAdapter context)
Computes boolean value of this reference Returns the actual value of reference return type boolean, and 'true' if value is not nulljava.lang.Object
execute(java.lang.Object o, InternalContextAdapter context)
gets an Object that 'is' the value of the referencejava.lang.String
getDollarBang()
private java.lang.String
getNullString(InternalContextAdapter context)
This method helps to implement the "render literal if null" functionality.private java.lang.String
getRoot()
java.lang.String
getRootString()
Returns the 'root string', the reference keyjava.lang.Object
getVariableValue(Context context, java.lang.String variable)
java.lang.Object
init(InternalContextAdapter context, java.lang.Object data)
java.lang.Object
jjtAccept(ParserVisitor visitor, java.lang.Object data)
static java.lang.String
printClass(java.lang.Class clazz)
Utility class to handle nulls when printing a class typeboolean
render(InternalContextAdapter context, java.io.Writer writer)
gets the value of the reference and outputs it to the writer.boolean
setValue(InternalContextAdapter context, java.lang.Object value)
Sets the value of a complex reference (something like $foo.bar) Currently used by ASTSetReference()java.lang.Object
value(InternalContextAdapter context)
-
Methods inherited from class org.apache.velocity.runtime.parser.node.SimpleNode
childrenAccept, dump, getColumn, getFirstToken, getInfo, getLastToken, getLine, getLocation, getRuntimeServices, getTemplateName, getType, isInvalid, jjtAddChild, jjtClose, jjtGetChild, jjtGetNumChildren, jjtGetParent, jjtOpen, jjtSetParent, literal, setFirstToken, setInfo, setInvalid, toString, toString
-
-
-
-
Field Detail
-
NORMAL_REFERENCE
private static final int NORMAL_REFERENCE
- See Also:
- Constant Field Values
-
FORMAL_REFERENCE
private static final int FORMAL_REFERENCE
- See Also:
- Constant Field Values
-
QUIET_REFERENCE
private static final int QUIET_REFERENCE
- See Also:
- Constant Field Values
-
RUNT
private static final int RUNT
- See Also:
- Constant Field Values
-
referenceType
private int referenceType
-
nullString
private java.lang.String nullString
-
rootString
private java.lang.String rootString
-
escaped
private boolean escaped
-
computableReference
private boolean computableReference
-
logOnNull
private boolean logOnNull
-
escPrefix
private java.lang.String escPrefix
-
morePrefix
private java.lang.String morePrefix
-
identifier
private java.lang.String identifier
-
literal
private java.lang.String literal
-
strictRef
public boolean strictRef
Indicates if we are running in strict reference mode.
-
astIndex
private ASTIndex astIndex
non null Indicates if we are setting an index reference e.g, $foo[2], which basically means that the last syntax of the reference are brackets.
-
strictEscape
public boolean strictEscape
Indicates if we are using modified escape behavior in strict mode. mainly we allow \$abc -> to render as $abc
-
toStringNullCheck
public boolean toStringNullCheck
Indicates if toString() should be called during condition evaluation just to ensure it does not return null. Check is unnecessary if all toString() implementations are known to have non-null return values. Disabling the check will give a performance improval since toString() may be a complex operation on large objects.
-
numChildren
private int numChildren
-
uberInfo
protected Info uberInfo
-
-
Constructor Detail
-
ASTReference
public ASTReference(int id)
- Parameters:
id
-
-
ASTReference
public ASTReference(Parser p, int id)
- Parameters:
p
-id
-
-
-
Method Detail
-
jjtAccept
public java.lang.Object jjtAccept(ParserVisitor visitor, java.lang.Object data)
- Specified by:
jjtAccept
in interfaceNode
- Overrides:
jjtAccept
in classSimpleNode
- Returns:
- The Node execution result object.
- See Also:
SimpleNode.jjtAccept(org.apache.velocity.runtime.parser.node.ParserVisitor, java.lang.Object)
-
init
public java.lang.Object init(InternalContextAdapter context, java.lang.Object data) throws TemplateInitException
- Specified by:
init
in interfaceNode
- Overrides:
init
in classSimpleNode
- Returns:
- The init result.
- Throws:
TemplateInitException
- See Also:
SimpleNode.init(org.apache.velocity.context.InternalContextAdapter, java.lang.Object)
-
getRootString
public java.lang.String getRootString()
Returns the 'root string', the reference key- Returns:
- the root string.
-
execute
public java.lang.Object execute(java.lang.Object o, InternalContextAdapter context) throws MethodInvocationException
gets an Object that 'is' the value of the reference- Specified by:
execute
in interfaceNode
- Overrides:
execute
in classSimpleNode
- Parameters:
o
- unused Object parametercontext
- context used to generate value- Returns:
- The execution result.
- Throws:
MethodInvocationException
- See Also:
Node.execute(java.lang.Object, org.apache.velocity.context.InternalContextAdapter)
-
render
public boolean render(InternalContextAdapter context, java.io.Writer writer) throws java.io.IOException, MethodInvocationException
gets the value of the reference and outputs it to the writer.- Specified by:
render
in interfaceNode
- Specified by:
render
in interfaceRenderable
- Overrides:
render
in classSimpleNode
- Parameters:
context
- context of data to use in getting valuewriter
- writer to render to- Returns:
- True if rendering was successful.
- Throws:
java.io.IOException
MethodInvocationException
- See Also:
Node.render(org.apache.velocity.context.InternalContextAdapter, java.io.Writer)
-
getNullString
private java.lang.String getNullString(InternalContextAdapter context)
This method helps to implement the "render literal if null" functionality. VelocimacroProxy saves references to macro arguments (AST nodes) so that if we have a macro #foobar($a $b) then there is key "$a.literal" which points to the literal presentation of the argument provided to variable $a. If the value of $a is null, we render the string that was provided as the argument.- Parameters:
context
-- Returns:
-
evaluate
public boolean evaluate(InternalContextAdapter context) throws MethodInvocationException
Computes boolean value of this reference Returns the actual value of reference return type boolean, and 'true' if value is not null- Specified by:
evaluate
in interfaceNode
- Overrides:
evaluate
in classSimpleNode
- Parameters:
context
- context to compute value with- Returns:
- True if evaluation was ok.
- Throws:
MethodInvocationException
- See Also:
Node.evaluate(org.apache.velocity.context.InternalContextAdapter)
-
value
public java.lang.Object value(InternalContextAdapter context) throws MethodInvocationException
- Specified by:
value
in interfaceNode
- Overrides:
value
in classSimpleNode
- Returns:
- The node value.
- Throws:
MethodInvocationException
- See Also:
SimpleNode.value(org.apache.velocity.context.InternalContextAdapter)
-
printClass
public static java.lang.String printClass(java.lang.Class clazz)
Utility class to handle nulls when printing a class type
-
setValue
public boolean setValue(InternalContextAdapter context, java.lang.Object value) throws MethodInvocationException
Sets the value of a complex reference (something like $foo.bar) Currently used by ASTSetReference()- Parameters:
context
- context object containing this referencevalue
- Object to set as value- Returns:
- true if successful, false otherwise
- Throws:
MethodInvocationException
- See Also:
ASTSetDirective
-
getRoot
private java.lang.String getRoot()
-
getVariableValue
public java.lang.Object getVariableValue(Context context, java.lang.String variable) throws MethodInvocationException
- Parameters:
context
-variable
-- Returns:
- The evaluated value of the variable.
- Throws:
MethodInvocationException
-
getDollarBang
public java.lang.String getDollarBang()
-
-