Package org.opencms.jsp

Class CmsJspTagInclude

java.lang.Object

javax.servlet.jsp.tagext.TagSupport

javax.servlet.jsp.tagext.BodyTagSupport

org.opencms.jsp.CmsJspTagInclude

All Implemented Interfaces:

Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag, I_CmsJspTagParamParent

public class CmsJspTagInclude
extends javax.servlet.jsp.tagext.BodyTagSupport
implements I_CmsJspTagParamParent

Implementation of the <cms:include/> tag, used to include another OpenCms managed resource in a JSP.

Since:

6.0.0

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 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	Description
CmsJspTagInclude()	Empty constructor, required for attribute value initialization.

Method Summary

Modifier and Type	Method	Description
void	addParameter(String name, String value)	This methods adds parameters to the current request.
static void	addParameter(Map<String,String[]> parameters, String name, String value, boolean overwrite)	Adds parameters to a parameter Map that can be used for a http request.
int	doEndTag()
int	doStartTag()	Returns BodyTag.EVAL_BODY_BUFFERED.
String	getAttribute()	Returns the attribute.
String	getCacheable()	Returns the cacheable flag.
String	getEditable()	Returns the editable flag.
String	getElement()	Returns the element.
String	getFile()	Returns the value of getPage().
String	getPage()	Returns the include page target.
String	getProperty()	Returns the property.
String	getSuffix()	Returns the suffix.
static void	includeTagAction(javax.servlet.jsp.PageContext context, String target, String element, boolean editable, Map<String,String[]> paramMap, Map<String,Object> attrMap, javax.servlet.ServletRequest req, javax.servlet.ServletResponse res)	Includes the selected target.
static void	includeTagAction(javax.servlet.jsp.PageContext context, String target, String element, Locale locale, boolean editable, boolean cacheable, Map<String,String[]> paramMap, Map<String,Object> attrMap, javax.servlet.ServletRequest req, javax.servlet.ServletResponse res)	Includes the selected target.
void	release()
void	setAttribute(String attribute)	Sets the attribute.
void	setCacheable(String cacheable)	Sets the cacheable flag.
void	setEditable(String editable)	Sets the editable flag.
void	setElement(String element)	Sets the element.
void	setFile(String file)	Sets the file, same as using setPage().
void	setPage(String target)	Sets the include page target.
void	setProperty(String property)	Sets the property.
void	setSuffix(String suffix)	Sets the suffix.

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

doAfterBody, doInitBody, getBodyContent, getPreviousOut, setBodyContent

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

findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, 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 Details

CmsJspTagInclude

public CmsJspTagInclude()

Empty constructor, required for attribute value initialization.

Method Details

addParameter

public static void addParameter(Map<String,String[]> parameters,
 String name,
 String value,
 boolean overwrite)

Adds parameters to a parameter Map that can be used for a http request.

Parameters:

parameters - the Map to add the parameters to

name - the name to add

value - the value to add

overwrite - if true, a parameter in the map will be overwritten by a parameter with the same name, otherwise the request will have multiple parameters with the same name (which is possible in http requests)

includeTagAction

public static void includeTagAction(javax.servlet.jsp.PageContext context,
 String target,
 String element,
 boolean editable,
 Map<String,String[]> paramMap,
 Map<String,Object> attrMap,
 javax.servlet.ServletRequest req,
 javax.servlet.ServletResponse res)
                             throws javax.servlet.jsp.JspException

Includes the selected target.

Parameters:

context - the current JSP page context

target - the target for the include, might be null

element - the element to select form the target might be null

editable - flag to indicate if the target is editable

paramMap - a map of parameters for the include, will be merged with the request parameters, might be null

attrMap - a map of attributes for the include, will be merged with the request attributes, might be null

req - the current request

res - the current response

Throws:

javax.servlet.jsp.JspException - in case something goes wrong

includeTagAction

public static void includeTagAction(javax.servlet.jsp.PageContext context,
 String target,
 String element,
 Locale locale,
 boolean editable,
 boolean cacheable,
 Map<String,String[]> paramMap,
 Map<String,Object> attrMap,
 javax.servlet.ServletRequest req,
 javax.servlet.ServletResponse res)
                             throws javax.servlet.jsp.JspException

Includes the selected target.

Parameters:

context - the current JSP page context

target - the target for the include, might be null

element - the element to select form the target, might be null

locale - the locale to use for the selected element, might be null

editable - flag to indicate if the target is editable

cacheable - flag to indicate if the target should be cacheable in the Flex cache

paramMap - a map of parameters for the include, will be merged with the request parameters, might be null

attrMap - a map of attributes for the include, will be merged with the request attributes, might be null

req - the current request

res - the current response

Throws:

javax.servlet.jsp.JspException - in case something goes wrong

addParameter

public void addParameter(String name,
 String value)

This methods adds parameters to the current request.

Parameters added here will be treated like parameters from the HttpRequest on included pages.

Remember that the value for a parameter in a HttpRequest is a String array, not just a simple String. If a parameter added here does not already exist in the HttpRequest, it will be added. If a parameter exists, another value will be added to the array of values. If the value already exists for the parameter, nothing will be added, since a value can appear only once per parameter.

Specified by:

addParameter in interface I_CmsJspTagParamParent

Parameters:

name - the name to add

value - the value to add

See Also:

• I_CmsJspTagParamParent.addParameter(String, String)

doEndTag

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

Specified by:

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

Overrides:

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

Returns:

EVAL_PAGE

Throws:

javax.servlet.jsp.JspException - by interface default

See Also:

• Tag.doEndTag()

doStartTag

public int doStartTag()

Returns BodyTag.EVAL_BODY_BUFFERED.

Specified by:

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

Overrides:

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

Returns:

BodyTag.EVAL_BODY_BUFFERED

See Also:

• Tag.doStartTag()

getAttribute

public String getAttribute()

Returns the attribute.

Returns:

the attribute

getCacheable

public String getCacheable()

Returns the cacheable flag.

Returns:

the cacheable flag

getEditable

public String getEditable()

Returns the editable flag.

Returns:

the editable flag

getElement

public String getElement()

Returns the element.

Returns:

the element

getFile

public String getFile()

Returns the value of getPage().

Returns:

the value of getPage()

See Also:

• getPage()

getPage

public String getPage()

Returns the include page target.

Returns:

the include page target

getProperty

public String getProperty()

Returns the property.

Returns:

the property

getSuffix

public String getSuffix()

Returns the suffix.

Returns:

the suffix

release

public void release()

Specified by:

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

Overrides:

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

See Also:

• Tag.release()

setAttribute

public void setAttribute(String attribute)

Sets the attribute.

Parameters:

attribute - the attribute to set

setCacheable

public void setCacheable(String cacheable)

Sets the cacheable flag.

Cachable is true by default.

Parameters:

cacheable - the flag to set

setEditable

public void setEditable(String editable)

Sets the editable flag.

Editable is false by default.

Parameters:

editable - the flag to set

setElement

public void setElement(String element)

Sets the element.

Parameters:

element - the element to set

setFile

public void setFile(String file)

Sets the file, same as using setPage().

Parameters:

file - the file to set

See Also:

• setPage(String)

setPage

public void setPage(String target)

Sets the include page target.

Parameters:

target - the target to set

setProperty

public void setProperty(String property)

Sets the property.

Parameters:

property - the property to set

setSuffix

public void setSuffix(String suffix)

Sets the suffix.

Parameters:

suffix - the suffix to set