Class UIComponentELTag
- java.lang.Object
-
- javax.faces.webapp.UIComponentTagBase
-
- javax.faces.webapp.UIComponentClassicTagBase
-
- javax.faces.webapp.UIComponentELTag
-
- All Implemented Interfaces:
javax.servlet.jsp.tagext.BodyTag,javax.servlet.jsp.tagext.IterationTag,javax.servlet.jsp.tagext.JspIdConsumer,javax.servlet.jsp.tagext.JspTag,javax.servlet.jsp.tagext.Tag
public abstract class UIComponentELTag extends UIComponentClassicTagBase implements javax.servlet.jsp.tagext.Tag
UIComponentELTagspecializes its superclass to allow for properties that take their values from EL API expressions.This tag is designed for use with Faces version 1.2 and JSP version 2.1 containers.
-
-
Field Summary
-
Fields inherited from class javax.faces.webapp.UIComponentClassicTagBase
bodyContent, pageContext, UNIQUE_ID_PREFIX
-
Fields inherited from class javax.faces.webapp.UIComponentTagBase
log
-
-
Constructor Summary
Constructors Constructor Description UIComponentELTag()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected UIComponentcreateComponent(FacesContext context, java.lang.String newId)Create and return a new child component of the type returned by callinggetComponentType().protected javax.el.ELContextgetELContext()Return theELContextfor theFacesContextfor this request.protected booleanhasBinding()Returntrueif this component has a non-nullbinding attribute.voidrelease()Release any resources allocated during the execution of this tag handler.voidsetBinding(javax.el.ValueExpression binding)Set the value expression for our component.protected voidsetProperties(UIComponent component)Override properties and attributes of the specified component, if the corresponding properties of this tag handler instance were explicitly set.voidsetRendered(javax.el.ValueExpression rendered)Set an override for the rendered attribute.-
Methods inherited from class javax.faces.webapp.UIComponentClassicTagBase
addChild, addFacet, addVerbatimAfterComponent, addVerbatimBeforeComponent, createVerbatimComponent, createVerbatimComponentFromBodyContent, doAfterBody, doEndTag, doInitBody, doStartTag, encodeBegin, encodeChildren, encodeEnd, findComponent, getBodyContent, getComponentInstance, getCreated, getCreatedComponents, getDoAfterBodyValue, getDoEndValue, getDoStartValue, getFacesContext, getFacesJspId, getFacetName, getId, getIndexOfNextChildTag, getJspId, getParent, getParentUIComponentClassicTagBase, getPreviousOut, setBodyContent, setId, setJspId, setPageContext, setParent, setupResponseWriter
-
Methods inherited from class javax.faces.webapp.UIComponentTagBase
getComponentType, getRendererType
-
-
-
-
Method Detail
-
setBinding
public void setBinding(javax.el.ValueExpression binding) throws javax.servlet.jsp.JspExceptionSet the value expression for our component.
- Parameters:
binding- The new value expression- Throws:
javax.servlet.jsp.JspException- if an error occurs
-
hasBinding
protected boolean hasBinding()
Description copied from class:UIComponentClassicTagBaseReturn
trueif this component has a non-nullbinding attribute. This method is necessary to allow subclasses that expose thebindingproperty as an Faces 1.1 style EL property as well as subclasses that expose it as an EL API property.- Specified by:
hasBindingin classUIComponentClassicTagBase
-
setRendered
public void setRendered(javax.el.ValueExpression rendered)
Set an override for the rendered attribute.
- Parameters:
rendered- The new value for rendered attribute
-
getELContext
protected javax.el.ELContext getELContext()
Return the
ELContextfor theFacesContextfor this request.This is a convenience for
getFacesContext().getELContext().- Overrides:
getELContextin classUIComponentTagBase
-
release
public void release()
Release any resources allocated during the execution of this tag handler.
- Specified by:
releasein interfacejavax.servlet.jsp.tagext.Tag- Overrides:
releasein classUIComponentClassicTagBase
-
setProperties
protected void setProperties(UIComponent component)
Override properties and attributes of the specified component, if the corresponding properties of this tag handler instance were explicitly set. This method must be called ONLY if the specified
UIComponentwas in fact created during the execution of this tag handler instance, and this call will occur BEFORE theUIComponentis added to the view.Tag subclasses that want to support additional set properties must ensure that the base class
setProperties()method is still called. A typical implementation that supports extra propertiesfooandbarwould look something like this:protected void setProperties(UIComponent component) { super.setProperties(component); if (foo != null) { component.setAttribute("foo", foo); } if (bar != null) { component.setAttribute("bar", bar); } }The default implementation overrides the following properties:
rendered- Set if a value for therenderedproperty is specified for this tag handler instance.rendererType- Set if thegetRendererType()method returns a non-null value.
- Specified by:
setPropertiesin classUIComponentClassicTagBase- Parameters:
component-UIComponentwhose properties are to be overridden
-
createComponent
protected UIComponent createComponent(FacesContext context, java.lang.String newId) throws javax.servlet.jsp.JspException
Create and return a new child component of the type returned by calling
getComponentType(). If thisUIComponentELTaghas a non-nullbindingattribute, this is done by callApplication.createComponent(java.lang.String)with theValueExpressioncreated for thebindingattribute, and theValueExpressionwill be stored on the component. Otherwise,Application.createComponent(java.lang.String)is called with only the component type. Finally, initialize the components id and other properties.- Specified by:
createComponentin classUIComponentClassicTagBase- Parameters:
context-FacesContextfor the current requestnewId- id of the component- Throws:
javax.servlet.jsp.JspException
-
-