com.opensymphony.module.sitemesh.taglib.page

Class ApplyDecoratorTag

java.lang.Object

javax.servlet.jsp.tagext.TagSupport

javax.servlet.jsp.tagext.BodyTagSupport

com.opensymphony.module.sitemesh.taglib.page.ApplyDecoratorTag

All Implemented Interfaces:

RequestConstants, java.io.Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag

public class ApplyDecoratorTag
extends javax.servlet.jsp.tagext.BodyTagSupport
implements RequestConstants

This tag inserts an external resource as a panel into the current Page.

The page attribute should point to the panel resource which should expose an entire page (e.g. another JSP file producing HTML). This attribute can be relative to the page it is being called from or an absolute path from the context-root.

OR

If the page attribute is not specified, the body content is parsed into the Page object and has the Decorator applied.

The (optional) decorator attribute is the name of the Decorator to apply to the included page. Note that the implementation of DecoratorMapper can overide this.

See Also:

Serialized Form

Field Summary

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

bodyContent

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

id, pageContext

Fields inherited from interface com.opensymphony.module.sitemesh.RequestConstants

DECORATOR, PAGE, ROBOT

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

EVAL_BODY_BUFFERED, EVAL_BODY_TAG

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
ApplyDecoratorTag()

Method Summary

Modifier and Type	Method and Description
int	doAfterBody() Ensure that external page contents are included in bodycontent.
int	doEndTag() Standard taglib method: apply decorator to page.
int	doStartTag()
void	setContentType(java.lang.String contentType)
void	setDecorator(java.lang.String decorator) Deprecated. Use setName() instead.
void	setEncoding(java.lang.String encoding)
void	setId(java.lang.String id) Tag attribute: If set, this value will override the 'id' property of the page.
void	setName(java.lang.String decorator) Tag attribute: Name of Decorator to apply to Page.
void	setPage(java.lang.String page) Tag attribute: URI of page to include.
void	setTitle(java.lang.String title) Tag attribute: If set, this value will override the 'title' property of the page.

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

doInitBody, getBodyContent, getPreviousOut, release, setBodyContent

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

findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setPageContext, setParent, setValue

Methods inherited from class java.lang.Object

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

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

getParent, setPageContext, setParent

Constructor Detail

ApplyDecoratorTag

public ApplyDecoratorTag()

Method Detail

setPage

public void setPage(java.lang.String page)

Tag attribute: URI of page to include. Can be relative to page being called from, or absolute path from context-root of web-app.

setTitle

public void setTitle(java.lang.String title)

Tag attribute: If set, this value will override the 'title' property of the page. This is a convenience utility and is identical to specifing a 'page:param name=title' tag.

setId

public void setId(java.lang.String id)

Tag attribute: If set, this value will override the 'id' property of the page. This is a convenience utility and is identical to specifing a 'page:param name=id' tag.

Overrides:

setId in class javax.servlet.jsp.tagext.TagSupport

setName

public void setName(java.lang.String decorator)

Tag attribute: Name of Decorator to apply to Page. This is passed to DecoratorMapper to retrieve appropriate Decorator. DecoratorMapper may override if needed.

See Also:

DecoratorMapper

setDecorator

public void setDecorator(java.lang.String decorator)

Deprecated. Use setName() instead.

setContentType

public void setContentType(java.lang.String contentType)

setEncoding

public void setEncoding(java.lang.String encoding)

doStartTag

public int doStartTag()

Specified by:

doStartTag in interface javax.servlet.jsp.tagext.Tag

Overrides:

doStartTag in class javax.servlet.jsp.tagext.BodyTagSupport

doAfterBody

public int doAfterBody()
                throws javax.servlet.jsp.JspException

Ensure that external page contents are included in bodycontent.

Specified by:

doAfterBody in interface javax.servlet.jsp.tagext.IterationTag

Overrides:

doAfterBody in class javax.servlet.jsp.tagext.BodyTagSupport

Throws:

javax.servlet.jsp.JspException

doEndTag

public int doEndTag()
             throws javax.servlet.jsp.JspException

Standard taglib method: apply decorator to page.

Specified by:

doEndTag in interface javax.servlet.jsp.tagext.Tag

Overrides:

doEndTag in class javax.servlet.jsp.tagext.BodyTagSupport

Throws:

javax.servlet.jsp.JspException