org.springframework.web.servlet.tags

Class EvalTag

java.lang.Object

javax.servlet.jsp.tagext.TagSupport

org.springframework.web.servlet.tags.RequestContextAwareTag

org.springframework.web.servlet.tags.HtmlEscapingAwareTag

org.springframework.web.servlet.tags.EvalTag

All Implemented Interfaces:

java.io.Serializable, IterationTag, JspTag, Tag, TryCatchFinally

public class EvalTag
extends HtmlEscapingAwareTag

The <eval> tag evaluates a Spring expression (SpEL) and either prints the result or assigns it to a variable. Supports the standard JSP evaluation context consisting of implicit variables and scoped attributes.

Attribute Summary

Attribute	Required?	Runtime Expression?	Description
expression	true	true	The expression to evaluate.
htmlEscape	false	true	Set HTML escaping for this tag, as a boolean value. Overrides the default HTML escaping setting for the current page.
javaScriptEscape	false	true	Set JavaScript escaping for this tag, as a boolean value. Default is false.
scope	false	true	The scope for the var. 'application', 'session', 'request' and 'page' scopes are supported. Defaults to page scope. This attribute has no effect unless the var attribute is also defined.
var	false	true	The name of the variable to export the evaluation result to. If not specified the evaluation result is converted to a String and written as output.

Since:

3.0.1

Author:

Keith Donald, Juergen Hoeller

See Also:

Serialized Form

Field Summary

Fields inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag

logger, REQUEST_CONTEXT_PAGE_ATTRIBUTE

Fields inherited from class javax.servlet.jsp.tagext.TagSupport

id, pageContext

Fields inherited from interface javax.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Fields inherited from interface javax.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

Constructors

Constructor and Description
EvalTag()

Method Summary

Modifier and Type	Method and Description
int	doEndTag()
int	doStartTagInternal() Called by doStartTag to perform the actual work.
void	setExpression(java.lang.String expression) Set the expression to evaluate.
void	setJavaScriptEscape(boolean javaScriptEscape) Set JavaScript escaping for this tag, as boolean value.
void	setScope(java.lang.String scope) Set the scope to export the evaluation result to.
void	setVar(java.lang.String var) Set the variable name to expose the evaluation result under.

Methods inherited from class org.springframework.web.servlet.tags.HtmlEscapingAwareTag

htmlEscape, isDefaultHtmlEscape, isHtmlEscape, isResponseEncodedHtmlEscape, setHtmlEscape

Methods inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag

doCatch, doFinally, doStartTag, getRequestContext

Methods inherited from class javax.servlet.jsp.tagext.TagSupport

doAfterBody, findAncestorWithClass, getId, getParent, getValue, getValues, release, removeValue, setId, setPageContext, setParent, setValue

Methods inherited from class java.lang.Object

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

Constructor Detail

EvalTag

public EvalTag()

Method Detail

setExpression

public void setExpression(java.lang.String expression)

Set the expression to evaluate.

setVar

public void setVar(java.lang.String var)

Set the variable name to expose the evaluation result under. Defaults to rendering the result to the current JspWriter.

setScope

public void setScope(java.lang.String scope)

Set the scope to export the evaluation result to. This attribute has no meaning unless var is also defined.

setJavaScriptEscape

public void setJavaScriptEscape(boolean javaScriptEscape)
                         throws JspException

Set JavaScript escaping for this tag, as boolean value. Default is "false".

Throws:

JspException

doStartTagInternal

public int doStartTagInternal()
                       throws JspException

Description copied from class: RequestContextAwareTag

Called by doStartTag to perform the actual work.

Specified by:

doStartTagInternal in class RequestContextAwareTag

Returns:

same as TagSupport.doStartTag

Throws:

JspException

See Also:

TagSupport.doStartTag()

doEndTag

public int doEndTag()
             throws JspException

Specified by:

doEndTag in interface Tag

Overrides:

doEndTag in class TagSupport

Throws:

JspException