org.opencms.jsp
Class CmsJspTagInfo

java.lang.Object
  javax.servlet.jsp.tagext.TagSupport
      org.opencms.jsp.CmsJspTagInfo

All Implemented Interfaces:

Serializable, IterationTag, Tag

public class CmsJspTagInfo
extends TagSupport

Provides access to OpenCms and System related information.

This tag supports the following special "property" values:

• opencms.version returns the current OpenCms version, e.g. 5.0 Kaitain
• opencms.url returns the current request URL, e.g. http://localhost:8080/opencms/opencms/index.jsp
• opencms.uri returns the current request URI, e.g. /opencms/opencms/index.jsp
• opencms.webapp returns the name of the OpenCms web application, e.g. opencms
• opencms.webbasepath returns the name of system path to the OpenCms web application, e.g. C:\Java\Tomcat\webapps\opencms\
• opencms.request.uri returns the name of the currently requested URI in the OpenCms VFS, e.g. /index.jsp
• opencms.request.element.uri returns the name of the currently processed element, which might be a sub-element like a template part, in the OpenCms VFS, e.g. /system/modules/org.opencms.welcome/jsptemplates/welcome.jsp
• opencms.request.folder returns the name of the parent folder of the currently requested URI in the OpenCms VFS, e.g. /
• opencms.request.encoding returns the content encoding that has been set for the currently requested resource, e.g. ISO-8859-1

All other property values that are passes to the tag as routed to a standard System.getProperty(value) call, so you can also get information about the Java VM environment, using values like java.vm.version or os.name.

If the given property value does not match a key from the special OpenCms values and also not the system values, a (String) message is returned with a formatted error message.

Since:

6.0.0

Version:

$Revision: 1.21 $

Author:

Alexander Kandzior

See Also:

Serialized Form

Field Summary

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

CmsJspTagInfo()

Method Summary

int	doStartTag()
String	getProperty() Returns the selected info property.
static String	infoTagAction(String property, HttpServletRequest req) Returns the selected info property value based on the provided parameters.
void	release()
void	setProperty(String name) Sets the info property name.

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

doAfterBody, doEndTag, 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

Constructor Detail

CmsJspTagInfo

public CmsJspTagInfo()

Method Detail

infoTagAction

public static String infoTagAction(String property,
                                   HttpServletRequest req)

Returns the selected info property value based on the provided parameters.

Parameters:

property - the info property to look up

req - the currents request

Returns:

the looked up property value

doStartTag

public int doStartTag()
               throws JspException

Specified by:

doStartTag in interface Tag

Overrides:

doStartTag in class TagSupport

Throws:

JspException

See Also:

Tag.doStartTag()

getProperty

public String getProperty()

Returns the selected info property.

Returns:

the selected info property

release

public void release()

Specified by:

release in interface Tag

Overrides:

release in class TagSupport

See Also:

Tag.release()

setProperty

public void setProperty(String name)

Sets the info property name.

Parameters:

name - the info property name to set