- java.lang.Object
-
- javax.faces.webapp.UIComponentTagBase
-
- javax.faces.webapp.UIComponentClassicTagBase
-
- javax.faces.webapp.UIComponentTag
-
- All Implemented Interfaces:
- BodyTag, IterationTag, JspIdConsumer, JspTag, Tag
- Direct Known Subclasses:
- UIComponentBodyTag
Deprecated.Use of this class has been replaced withUIComponentELTag
, which extendsUIComponentClassicTagBase
to add properties that use the EL API introduced as part of JSP 2.1.
public abstract class UIComponentTag extends UIComponentClassicTagBase implements Tag
UIComponentTag
is the base class for all JSP custom actions that correspond to user interface components in a page that is rendered by JavaServer Faces.In this version of the specification,
UIComponentTag
extendsUIComponentClassicTagBase
to add properties that use the Faces 1.1 Expression Language.
-
-
Field Summary
-
Fields inherited from class javax.faces.webapp.UIComponentClassicTagBase
bodyContent, pageContext, UNIQUE_ID_PREFIX
-
Fields inherited from class javax.faces.webapp.UIComponentTagBase
log
-
Fields inherited from interface javax.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
-
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
-
-
Constructor Summary
Constructors Constructor and Description UIComponentTag()
Deprecated.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method and Description protected UIComponent
createComponent(FacesContext context, String newId)
Deprecated.ImplementcreateComponent
using Faces 1.1 EL API.static UIComponentTag
getParentUIComponentTag(PageContext context)
Deprecated.Locate and return the nearest enclosingUIComponentTag
if any; otherwise, returnnull
.protected boolean
hasBinding()
Deprecated.Returntrue
if this component has a non-null
binding attribute.protected boolean
isSuppressed()
Deprecated.static boolean
isValueReference(String value)
Deprecated.Returntrue
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(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(String rendered)
Deprecated.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, getELContext, getRendererType
-
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
doEndTag, doStartTag, getParent, setPageContext, setParent
-
-
-
-
Method Detail
-
setBinding
public void setBinding(String binding) throws JspException
Deprecated.Set the value binding expression for our component.
- Parameters:
binding
- The new value binding expression- Throws:
IllegalArgumentException
- if the specified binding is not a valid value binding expression.JspException
-
hasBinding
protected boolean hasBinding()
Deprecated.Description copied from class:UIComponentClassicTagBase
Return
true
if this component has a non-null
binding attribute. This method is necessary to allow subclasses that expose thebinding
property as an Faces 1.1 style EL property as well as subclasses that expose it as an EL API property.- Specified by:
hasBinding
in classUIComponentClassicTagBase
-
setRendered
public void setRendered(String rendered)
Deprecated.Set an override for the rendered attribute.
- Parameters:
rendered
- The new value for rendered attribute
-
isSuppressed
protected boolean isSuppressed()
Deprecated.
-
isValueReference
public static boolean isValueReference(String value)
Deprecated.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 underlyingUIComponent
.- Parameters:
value
- The value to evaluate- Throws:
NullPointerException
- ifvalue
isnull
-
release
public void release()
Deprecated.Release any resources allocated during the execution of this tag handler.
- Specified by:
release
in interfaceTag
- Overrides:
release
in classUIComponentClassicTagBase
-
setProperties
protected void setProperties(UIComponent component)
Deprecated.Description copied from class: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 theUIComponent
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 propertiesfoo
andbar
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 therendered
property is specified for this tag handler instance.rendererType
- Set if thegetRendererType()
method returns a non-null value.
- Specified by:
setProperties
in classUIComponentClassicTagBase
- Parameters:
component
-UIComponent
whose properties are to be overridden
-
createComponent
protected UIComponent createComponent(FacesContext context, String newId)
Deprecated.Implement
createComponent
using Faces 1.1 EL API.- Specified by:
createComponent
in classUIComponentClassicTagBase
- Parameters:
context
-FacesContext
for the current requestnewId
- id of the component
-
getParentUIComponentTag
public static UIComponentTag getParentUIComponentTag(PageContext context)
Deprecated.Locate and return the nearest enclosing
UIComponentTag
if any; otherwise, returnnull
.- Parameters:
context
-PageContext
for the current page
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 18/08/2025
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-javaee-rf-javax/faces/webapp/UIComponentTag.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor dieser Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.