|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--javax.servlet.jsp.tagext.TagSupport | +--org.apache.struts.taglib.tiles.DefinitionTagSupport | +--org.apache.struts.taglib.tiles.InsertTag
This is the tag handler for <tiles:insert>, which includes a template. The tag's body content consists of <tiles:put> tags, which are accessed by <tiles:get> in the template.
Nested Class Summary | |
protected class |
InsertTag.DirectStringHandler
Handle insert direct string. |
protected class |
InsertTag.InsertHandler
Real handler, after attribute resolution. |
protected static interface |
InsertTag.TagHandler
Inner Interface. |
Field Summary | |
protected java.lang.String |
attribute
Name of attribute from which to read page name to include |
protected java.lang.String |
beanName
Name of bean used as entity to include |
protected java.lang.String |
beanProperty
Name of bean property, if any |
protected java.lang.String |
beanScope
Scope of bean, if any |
protected ComponentContext |
cachedCurrentContext
Current component context |
protected java.lang.String |
definitionName
Name of component instance to include |
protected boolean |
flush
Flush attribute value |
protected boolean |
isErrorIgnored
Are errors ignored. |
protected static org.apache.commons.logging.Log |
log
Commons Logging instance. |
protected java.lang.String |
name
Name to insert |
protected javax.servlet.jsp.PageContext |
pageContext
Trick to allows inner classes to access pageContext |
protected boolean |
processEndTag
Does the end tag need to be processed. |
static java.lang.String |
ROLE_DELIMITER
The role delimiter. |
protected InsertTag.TagHandler |
tagHandler
Finale handler of tag methods |
Fields inherited from class org.apache.struts.taglib.tiles.DefinitionTagSupport |
controllerName, controllerType, page, role |
Fields inherited from class javax.servlet.jsp.tagext.TagSupport |
id |
Fields inherited from interface org.apache.struts.taglib.tiles.ComponentConstants |
COMPONENT_CONTEXT, COMPONENT_SCOPE, EXCEPTION_KEY, LOCALE_KEY |
Fields inherited from interface javax.servlet.jsp.tagext.Tag |
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE |
Constructor Summary | |
InsertTag()
|
Method Summary | |
InsertTag.TagHandler |
createTagHandler()
Process tag attribute and create corresponding tag handler. |
int |
doEndTag()
Process the end tag by including the template. |
protected void |
doInclude(java.lang.String page)
Do an include of specified page. |
int |
doStartTag()
Process the start tag by checking tag's attributes and creating appropriate handler. |
java.lang.String |
getBeanName()
Get bean name. |
java.lang.String |
getBeanProperty()
Get bean property. |
java.lang.String |
getBeanScope()
Get bean scope. |
private Controller |
getController()
Get instantiated Controller. |
private ComponentContext |
getCurrentContext()
Get current component context. |
java.lang.String |
getDefinitionName()
Get definition name. |
boolean |
getFlush()
Get flush. |
boolean |
getIgnore()
Get ignore. |
java.lang.String |
getName()
Get name. |
javax.servlet.jsp.PageContext |
getPageContext()
Get the pageContext property. |
InsertTag.TagHandler |
processAsDefinitionOrURL(java.lang.String name)
Try to process name as a definition, or as an URL if not found. |
InsertTag.TagHandler |
processAttribute(java.lang.String name)
Process tag attribute "attribute". |
protected InsertTag.TagHandler |
processBean(java.lang.String beanName,
java.lang.String beanProperty,
java.lang.String beanScope)
Process a bean. |
protected InsertTag.TagHandler |
processDefinition(ComponentDefinition definition)
End of Process tag attribute "definition". |
protected InsertTag.TagHandler |
processDefinitionName(java.lang.String name)
Process tag attribute "definition". |
InsertTag.TagHandler |
processName(java.lang.String name)
Process name. |
void |
processNestedTag(PutListTag nestedTag)
Process nested ≶putList> tag. |
void |
processNestedTag(PutTag nestedTag)
Process nested ≶put> tag. |
InsertTag.TagHandler |
processObjectValue(java.lang.Object value)
Process an object retrieved as a bean or attribute. |
InsertTag.TagHandler |
processTypedAttribute(AttributeDefinition value)
Process typed attribute according to its type. |
InsertTag.TagHandler |
processUrl(java.lang.String url)
Process the url. |
void |
putAttribute(PutListTag nestedTag)
Method calls by nested ≶putList> tags. |
void |
putAttribute(java.lang.String name,
java.lang.Object value)
Add a body attribute. |
void |
release()
Reset member values for reuse. |
protected void |
releaseInternal()
Reset internal member values for reuse. |
void |
setAttribute(java.lang.String value)
Set attribute. |
void |
setBeanName(java.lang.String value)
Set bean name. |
void |
setBeanProperty(java.lang.String value)
Set bean property. |
void |
setBeanScope(java.lang.String value)
Set bean scope. |
void |
setComponent(java.lang.String name)
Set component. |
void |
setDefinition(java.lang.String name)
Set definition. |
void |
setFlush(boolean flush)
Set flush. |
void |
setFlush(java.lang.String flush)
Set flush. |
void |
setIgnore(boolean ignore)
Set ignore. |
void |
setInstance(java.lang.String name)
Deprecated. Use setDefinition() instead. |
void |
setName(java.lang.String value)
Set name. |
void |
setPageContext(javax.servlet.jsp.PageContext pc)
Set the current page context. |
static boolean |
userHasRole(javax.servlet.http.HttpServletRequest request,
java.lang.String role)
Parse the list of roles and return true or false based on whether
the user has that role or not. |
Methods inherited from class org.apache.struts.taglib.tiles.DefinitionTagSupport |
getControllerName, getControllerType, getPage, getRole, getTemplate, setController, setControllerClass, setControllerName, setControllerType, setControllerUrl, setPage, setRole, setTemplate |
Methods inherited from class javax.servlet.jsp.tagext.TagSupport |
findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setParent, setValue |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected static org.apache.commons.logging.Log log
protected boolean flush
protected java.lang.String name
protected java.lang.String attribute
protected java.lang.String beanName
protected java.lang.String beanProperty
protected java.lang.String beanScope
protected boolean isErrorIgnored
protected java.lang.String definitionName
protected boolean processEndTag
protected ComponentContext cachedCurrentContext
protected InsertTag.TagHandler tagHandler
protected javax.servlet.jsp.PageContext pageContext
public static final java.lang.String ROLE_DELIMITER
Constructor Detail |
public InsertTag()
Method Detail |
public void release()
release
in interface javax.servlet.jsp.tagext.Tag
release
in class DefinitionTagSupport
protected void releaseInternal()
public void setPageContext(javax.servlet.jsp.PageContext pc)
Needed to allow inner classes to access pageContext.
setPageContext
in interface javax.servlet.jsp.tagext.Tag
setPageContext
in class javax.servlet.jsp.tagext.TagSupport
public javax.servlet.jsp.PageContext getPageContext()
public void setName(java.lang.String value)
public java.lang.String getName()
public void setComponent(java.lang.String name)
public void setInstance(java.lang.String name)
public void setDefinition(java.lang.String name)
public java.lang.String getDefinitionName()
public void setAttribute(java.lang.String value)
public void setBeanName(java.lang.String value)
public java.lang.String getBeanName()
public void setBeanProperty(java.lang.String value)
public java.lang.String getBeanProperty()
public void setBeanScope(java.lang.String value)
public java.lang.String getBeanScope()
public void setFlush(boolean flush)
public boolean getFlush()
public void setFlush(java.lang.String flush)
public void setIgnore(boolean ignore)
public boolean getIgnore()
public void putAttribute(java.lang.String name, java.lang.Object value)
public void processNestedTag(PutTag nestedTag) throws javax.servlet.jsp.JspException
processNestedTag
in interface PutTagParent
nestedTag
- Nested tag to process.
javax.servlet.jsp.JspException
public void processNestedTag(PutListTag nestedTag) throws javax.servlet.jsp.JspException
processNestedTag
in interface PutListTagParent
nestedTag
- Nested PutTag defining the attribute.
javax.servlet.jsp.JspException
public void putAttribute(PutListTag nestedTag) throws javax.servlet.jsp.JspException
javax.servlet.jsp.JspException
private ComponentContext getCurrentContext()
private Controller getController() throws javax.servlet.jsp.JspException
null
if controllerType
is null.
javax.servlet.jsp.JspException
- If controller can't be created.public int doStartTag() throws javax.servlet.jsp.JspException
doStartTag
in interface javax.servlet.jsp.tagext.Tag
doStartTag
in class javax.servlet.jsp.tagext.TagSupport
javax.servlet.jsp.JspException
public int doEndTag() throws javax.servlet.jsp.JspException
doEndTag
in interface javax.servlet.jsp.tagext.Tag
doEndTag
in class javax.servlet.jsp.tagext.TagSupport
javax.servlet.jsp.JspException
public InsertTag.TagHandler createTagHandler() throws javax.servlet.jsp.JspException
javax.servlet.jsp.JspException
public InsertTag.TagHandler processObjectValue(java.lang.Object value) throws javax.servlet.jsp.JspException
javax.servlet.jsp.JspException
- - Throws by underlying nested call to processDefinitionName()public InsertTag.TagHandler processName(java.lang.String name) throws javax.servlet.jsp.JspException
javax.servlet.jsp.JspException
- - Throws by underlying nested call to processDefinitionName()public InsertTag.TagHandler processUrl(java.lang.String url) throws javax.servlet.jsp.JspException
javax.servlet.jsp.JspException
- If failed to create controllerprotected InsertTag.TagHandler processDefinitionName(java.lang.String name) throws javax.servlet.jsp.JspException
name
- Name of the definition.
JspException-
- NoSuchDefinitionException No Definition found for name.
JspException-
- FactoryNotFoundException Can't find Definitions factory.
JspException-
- DefinedComponentFactoryException General error in factory.
javax.servlet.jsp.JspException
- InstantiationException Can't create requested controllerprotected InsertTag.TagHandler processDefinition(ComponentDefinition definition) throws javax.servlet.jsp.JspException
definition
- Definition to process.
javax.servlet.jsp.JspException
- InstantiationException Can't create requested controllerprotected InsertTag.TagHandler processBean(java.lang.String beanName, java.lang.String beanProperty, java.lang.String beanScope) throws javax.servlet.jsp.JspException
beanName
- Name of the beanbeanProperty
- Property in the bean, or null.beanScope
- bean scope, or null.
javax.servlet.jsp.JspException
- - NoSuchDefinitionException No value associated to bean.
javax.servlet.jsp.JspException
- an error occur while reading bean, or no definition found.
javax.servlet.jsp.JspException
- - Throws by underlying nested call to processDefinitionName()public InsertTag.TagHandler processAttribute(java.lang.String name) throws javax.servlet.jsp.JspException
name
- Name of the attribute.
javax.servlet.jsp.JspException
- - NoSuchDefinitionException No Definition found for name.
javax.servlet.jsp.JspException
- - Throws by underlying nested call to processDefinitionName()public InsertTag.TagHandler processAsDefinitionOrURL(java.lang.String name) throws javax.servlet.jsp.JspException
name
- Name to process.
javax.servlet.jsp.JspException
- InstantiationException Can't create requested controllerpublic InsertTag.TagHandler processTypedAttribute(AttributeDefinition value) throws javax.servlet.jsp.JspException
value
- Typed attribute to process.
javax.servlet.jsp.JspException
- - Throws by underlying nested call to processDefinitionName()protected void doInclude(java.lang.String page) throws javax.servlet.ServletException, java.io.IOException
page
- The page that will be included
javax.servlet.ServletException
- - Thrown by call to pageContext.include()
java.io.IOException
- - Thrown by call to pageContext.include()public static boolean userHasRole(javax.servlet.http.HttpServletRequest request, java.lang.String role)
true
or false
based on whether
the user has that role or not.
role
- Comma-delimited list of roles.request
- The request.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |