UIComponentELTag, which extends
UIComponentClassicTagBase to add properties that use the Jakarta Expression Language API introduced as
part of Jakarta Server Pages 2.1.@Deprecated public abstract class UIComponentTag extends UIComponentClassicTagBase implements Tag
UIComponentTag is the base class for all Jakarta Server Pages custom actions that correspond to user
interface components in a page that is rendered by Jakarta Server Faces.
In this version of the specification, UIComponentTag extends UIComponentClassicTagBase to add
properties that use the Faces 1.1 Expression Language.
bodyContent, pageContext, UNIQUE_ID_PREFIXlogEVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGEEVAL_BODY_BUFFERED, EVAL_BODY_TAGEVAL_BODY_AGAIN| Constructor and Description |
|---|
UIComponentTag()
Deprecated.
|
| Modifier and Type | Method and Description |
|---|---|
protected UIComponent |
createComponent(FacesContext context,
java.lang.String newId)
Deprecated.
Implement
createComponent using Faces 1.1 EL API. |
static UIComponentTag |
getParentUIComponentTag(PageContext context)
Deprecated.
Locate and return the nearest enclosing
UIComponentTag if any; otherwise, return null. |
protected boolean |
hasBinding()
Deprecated.
Return
true if this component has a non-null binding attribute. |
protected boolean |
isSuppressed()
Deprecated.
|
static boolean |
isValueReference(java.lang.String value)
Deprecated.
Return
true if the specified value conforms to the syntax requirements of a value binding expression. |
void |
release()
Deprecated.
Release any resources allocated during the execution of this tag handler.
|
void |
setBinding(java.lang.String binding)
Deprecated.
Set the value binding expression for our component.
|
protected void |
setProperties(UIComponent component)
Deprecated.
Override properties and attributes of the specified component, if the corresponding properties of this tag handler
instance were explicitly set.
|
void |
setRendered(java.lang.String rendered)
Deprecated.
Set an override for the rendered attribute.
|
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, setupResponseWritergetComponentType, getELContext, getRendererTypeclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitdoEndTag, doStartTag, getParent, setPageContext, setParentpublic void setBinding(java.lang.String binding)
throws JspException
Set the value binding expression for our component.
binding - The new value binding expressionjava.lang.IllegalArgumentException - if the specified binding is not a valid value binding expression.JspException - if the binding cannot be setprotected boolean hasBinding()
UIComponentClassicTagBase
Return true if this component has a non-null binding attribute. This method is necessary to
allow subclasses that expose the binding property as an Faces 1.1 style Expression Language property as
well as subclasses that expose it as a Jakarta Expression Language API property.
hasBinding in class UIComponentClassicTagBasepublic void setRendered(java.lang.String rendered)
Set an override for the rendered attribute.
rendered - The new value for rendered attributeprotected boolean isSuppressed()
public static boolean isValueReference(java.lang.String value)
Return true if the specified value conforms to the syntax requirements of a value binding expression.
Such expressions ` * may be used on most component tag attributes to signal a desire for deferred evaluation of the
attribute or property value to be set on the underlying UIComponent.
value - The value to evaluatejava.lang.NullPointerException - if value is nullpublic void release()
Release any resources allocated during the execution of this tag handler.
release in interface Tagrelease in class UIComponentClassicTagBaseprotected void setProperties(UIComponent component)
UIComponentClassicTagBase
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 UIComponent
was in fact created during the execution of this tag handler instance, and this call will occur
BEFORE the UIComponent is 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 properties
foo and bar would 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 the rendered property is specified for this tag handler
instance.rendererType - Set if the getRendererType() method returns a non-null value.setProperties in class UIComponentClassicTagBasecomponent - UIComponent whose properties are to be overriddenprotected UIComponent createComponent(FacesContext context, java.lang.String newId)
Implement createComponent using Faces 1.1 EL API.
createComponent in class UIComponentClassicTagBasecontext - FacesContext for the current requestnewId - id of the componentpublic static UIComponentTag getParentUIComponentTag(PageContext context)
Locate and return the nearest enclosing UIComponentTag if any; otherwise, return null.
context - PageContext for the current page