freemarker.template.expression
Class MethodCall

java.lang.Object
  |
  +--freemarker.template.expression.MethodCall
All Implemented Interfaces:
Expression, ExpressionElement, Operator, java.io.Serializable, Unary, Variable

public final class MethodCall
extends java.lang.Object
implements Unary, Variable, java.io.Serializable

A unary operator that calls a TemplateMethodModel. It associates with other Variable expressions to its left.

Version:
$Id: MethodCall.java,v 1.35 2003/11/27 11:36:45 run2000 Exp $
See Also:
Serialized Form

Fields inherited from interface freemarker.template.expression.Unary
POSTFIX, PREFIX
 
Constructor Summary
MethodCall(java.util.List arguments)
          Constructor that takes a List of Expressions to be evaluated at method call time.
 
Method Summary
 boolean equals(java.lang.Object o)
          Determines whether this object is equal to the given object.
 ListLiteral getArguments()
          Retrieve the Expressions to be evaluated at call time.
 int getAssociationType()
          Retrieve the operator association for this operator.
 TemplateModel getAsTemplateModel(TemplateModelRoot modelRoot)
          The TemplateModel value of this method call.
 java.lang.String getName(TemplateModelRoot modelRoot)
          Retrieve the name of this portion of the variable.
 int getOperatorClass()
          Return the type of operator this is to the caller.
 Expression getTarget()
          Retrieves the target of this MethodCall operator.
 int getType()
          Determine the type of result that can be calculated by this expression.
 int hashCode()
          Returns the hash code for this operator.
 boolean isComplete()
          Are both the target and the arguments specified?
 void setTarget(Expression target)
          Sets the target of this MethodCall operator.
 java.lang.String toString()
          Returns a string representation of the object.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

MethodCall

public MethodCall(java.util.List arguments)
Constructor that takes a List of Expressions to be evaluated at method call time.
Parameters:
arguments - a List of Expressions
Throws:
NullPointerException - the argument list is null
Method Detail

getArguments

public ListLiteral getArguments()
Retrieve the Expressions to be evaluated at call time.
Returns:
a ListLiteral of arguments to be evaluated

getName

public java.lang.String getName(TemplateModelRoot modelRoot)
                         throws TemplateException
Retrieve the name of this portion of the variable.
Specified by:
getName in interface Variable
Parameters:
modelRoot - the model to be used in cases where the variable is the result of an Expression.
Throws:
TemplateException - the name could not be determined

getAsTemplateModel

public TemplateModel getAsTemplateModel(TemplateModelRoot modelRoot)
                                 throws TemplateException
The TemplateModel value of this method call.
Specified by:
getAsTemplateModel in interface Expression
Parameters:
modelRoot - the template model that will be evaluated by the expression
Returns:
the TemplateModel returned by the method call
Throws:
TemplateException - the expression could not be evaluated for some reason

isComplete

public boolean isComplete()
Are both the target and the arguments specified?
Specified by:
isComplete in interface Expression
Returns:
true if both target and arguments are specified, otherwise false

getType

public int getType()
Determine the type of result that can be calculated by this expression. This is in the form of an integer constant ored together from values in the ExpressionUtils class.
Specified by:
getType in interface Expression

getAssociationType

public int getAssociationType()
Retrieve the operator association for this operator.
Specified by:
getAssociationType in interface Unary
Returns:
POSTFIX.

setTarget

public void setTarget(Expression target)
Sets the target of this MethodCall operator.
Specified by:
setTarget in interface Unary
Throws:
java.lang.IllegalArgumentException - the target is of the wrong type for this operator.

getTarget

public Expression getTarget()
Retrieves the target of this MethodCall operator.
Returns:
an Expression representing the TemplateMethodModel to be called

getOperatorClass

public int getOperatorClass()
Return the type of operator this is to the caller. Used for associating operators according to precedence.
Specified by:
getOperatorClass in interface Operator
Returns:
an integer indicating the type of operator this is

toString

public java.lang.String toString()
Returns a string representation of the object.
Overrides:
toString in class java.lang.Object
Returns:
a String representation of this expression

equals

public boolean equals(java.lang.Object o)
Determines whether this object is equal to the given object.
Overrides:
equals in class java.lang.Object
Parameters:
o - the object to be compared with
Returns:
true if the objects are equal, otherwise false

hashCode

public int hashCode()
Returns the hash code for this operator.
Overrides:
hashCode in class java.lang.Object
Returns:
the hash code of this object