org.springframework.web.servlet.tags

Class EscapeBodyTag

java.lang.Object

TagSupport

org.springframework.web.servlet.tags.RequestContextAwareTag

org.springframework.web.servlet.tags.HtmlEscapingAwareTag

org.springframework.web.servlet.tags.EscapeBodyTag

public class EscapeBodyTag
extends HtmlEscapingAwareTag

Custom JSP tag to escape its enclosed body content, applying HTML escaping and/or JavaScript escaping.

Provides a "htmlEscape" property for explicitly specifying whether to apply HTML escaping. If not set, a page-level default (e.g. from the HtmlEscapeTag) or an application-wide default (the "defaultHtmlEscape" context-param in web.xml) is used.

Provides a "javaScriptEscape" property for specifying whether to apply JavaScript escaping. Can be combined with HTML escaping or used standalone.

Since:

1.1.1

Author:

Juergen Hoeller

See Also:

HtmlUtils, JavaScriptUtils

Field Summary

Fields

Modifier and Type	Field and Description
private BodyContent	bodyContent
private boolean	javaScriptEscape

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

logger, REQUEST_CONTEXT_PAGE_ATTRIBUTE

Constructor Summary

Constructors

Constructor and Description
EscapeBodyTag()

Method Summary

Modifier and Type	Method and Description
int	doAfterBody()
void	doInitBody()
protected int	doStartTagInternal() Called by doStartTag to perform the actual work.
protected java.lang.String	readBodyContent() Read the unescaped body content from the page.
void	setBodyContent(BodyContent bodyContent)
void	setJavaScriptEscape(boolean javaScriptEscape) Set JavaScript escaping for this tag, as boolean value.
protected void	writeBodyContent(java.lang.String content) Write the escaped body content to the page.

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 java.lang.Object

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

Field Detail

javaScriptEscape

private boolean javaScriptEscape

bodyContent

private BodyContent bodyContent

Constructor Detail

EscapeBodyTag

public EscapeBodyTag()

Method Detail

setJavaScriptEscape

public void setJavaScriptEscape(boolean javaScriptEscape)
                         throws JspException

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

Throws:

JspException

doStartTagInternal

protected int doStartTagInternal()

Description copied from class: RequestContextAwareTag

Called by doStartTag to perform the actual work.

Specified by:

doStartTagInternal in class RequestContextAwareTag

Returns:

same as TagSupport.doStartTag

See Also:

javax.servlet.jsp.tagext.TagSupport#doStartTag

doInitBody

public void doInitBody()

setBodyContent

public void setBodyContent(BodyContent bodyContent)

doAfterBody

public int doAfterBody()
                throws JspException

Throws:

JspException

readBodyContent

protected java.lang.String readBodyContent()
                                    throws java.io.IOException

Read the unescaped body content from the page.

Returns:

the original content

Throws:

java.io.IOException - if reading failed

writeBodyContent

protected void writeBodyContent(java.lang.String content)
                         throws java.io.IOException

Write the escaped body content to the page.

Can be overridden in subclasses, e.g. for testing purposes.

Parameters:

content - the content to write

Throws:

java.io.IOException - if writing failed