com.devsphere.xml.taglib.process.tag
Class Data

java.lang.Object
  |
  +--javax.servlet.jsp.tagext.TagSupport
        |
        +--javax.servlet.jsp.tagext.BodyTagSupport
              |
              +--com.devsphere.xml.taglib.support.tag.CommonSupport
                    |
                    +--com.devsphere.xml.taglib.process.tag.ProcessSupport
                          |
                          +--com.devsphere.xml.taglib.process.tag.Data

All Implemented Interfaces:

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

public class Data

extends ProcessSupport

Handler for the <p:data> tag, whose body can process a characters() SAX event. It exports a variable that holds the character data.

See Also:

Serialized Form

Field Summary

Fields inherited from class com.devsphere.xml.taglib.process.tag.ProcessSupport

ancestor, event, handler, indentLevel

Fields inherited from class com.devsphere.xml.taglib.support.tag.CommonSupport

cachedDebug, cachedLogger, DEBUG_ATTR, DEFAULT_DEBUG, DEFAULT_RESTORE_VALUE, DEFAULT_SCOPE, LOGGER_ATTR, originalValues

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

Data()

Method Summary

protected boolean	continueLoop() Returns false since the tag's body needs to be evaluated only once in order to process the character data.
protected void	exportVariables() Exports the data variable.
protected java.util.List	getAllowedAncestors() Returns the list of names of the tags that may contain the tag that is handled by this class.
java.lang.String	getTagName() Returns the name of the handled tag
protected void	init() Initializes the fields of this tag handler.
protected void	initLoop() Initializes the loop to process data events.
void	setScope(java.lang.String scope) Sets the default scope for the variables exported by this tag handler.
void	setScopeData(java.lang.String scopeData) Sets the scope of the data variable exported by this tag handler.
void	setVarData(java.lang.String varData) Sets the name of the data variable exported by this tag handler.
protected boolean	startLoop() Returns true if the current event is a Characters instance.

Methods inherited from class com.devsphere.xml.taglib.process.tag.ProcessSupport

doAfterBody, doEndTag, doFinally, doStartTag, finalizeLoop, getEvent, logEvent, logEvent, removeEvent, validate

Methods inherited from class com.devsphere.xml.taglib.support.tag.CommonSupport

checkVarName, checkVarScope, doCatch, eval, evalBoolean, evalDouble, evalInt, evalString, export, export, getDebug, getLogger, log, log, log, restore

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, 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 Detail

Data

public Data()

Method Detail

init

protected void init()

Initializes the fields of this tag handler.

Overrides:

init in class ProcessSupport

getTagName

public java.lang.String getTagName()

Returns the name of the handled tag

Specified by:

getTagName in class CommonSupport

Returns:

the name of the handled tag

getAllowedAncestors

protected java.util.List getAllowedAncestors()

Returns the list of names of the tags that may contain the tag that is handled by this class.

Specified by:

getAllowedAncestors in class CommonSupport

Returns:

the list of names of the allowed ancestor tags or null if the tag context doesn't matter.

setVarData

public void setVarData(java.lang.String varData)
                throws javax.servlet.jsp.JspException

Sets the name of the data variable exported by this tag handler. The value of the data variable will be the XML character data. The default name of this variable is data.

Parameters:

varData - the name of the data variable

Throws:

javax.servlet.jsp.JspException - to signal any error that might occur

setScopeData

public void setScopeData(java.lang.String scopeData)
                  throws javax.servlet.jsp.JspException

Sets the scope of the data variable exported by this tag handler.

Parameters:

scopeData - the scope of the data variable

Throws:

javax.servlet.jsp.JspException - to signal any error that might occur

setScope

public void setScope(java.lang.String scope)
              throws javax.servlet.jsp.JspException

Sets the default scope for the variables exported by this tag handler.

Parameters:

scope - the default scope of the exported variables

Throws:

javax.servlet.jsp.JspException - to signal any error that might occur

initLoop

protected void initLoop()
                 throws javax.servlet.jsp.JspException

Initializes the loop to process data events.

Overrides:

initLoop in class ProcessSupport

Throws:

javax.servlet.jsp.JspException - to signal any tag validation error

exportVariables

protected void exportVariables()

Exports the data variable.

startLoop

protected boolean startLoop()
                     throws javax.servlet.jsp.JspException

Returns true if the current event is a Characters instance. If this event is followed by other Characters events their data is concatenated. The data variable is exported containing the character data as value.

Specified by:

startLoop in class ProcessSupport

Returns:

true if the event loop should be started

Throws:

javax.servlet.jsp.JspException - to signal an error

continueLoop

protected boolean continueLoop()
                        throws javax.servlet.jsp.JspException

Returns false since the tag's body needs to be evaluated only once in order to process the character data.

Specified by:

continueLoop in class ProcessSupport

Returns:

false

Throws:

javax.servlet.jsp.JspException - to signal an error