- java.lang.Object
-
- javax.servlet.jsp.tagext.TagSupport
-
- javax.faces.webapp.ConverterTag
-
- All Implemented Interfaces:
- Serializable, IterationTag, JspTag, Tag
Deprecated.This has been partially replaced byConverterELTag
. The remainder of the functionality, namely, the binding facility and the implementation of thecreateConverter()
method, is now an implementation detail.
public class ConverterTag extends TagSupport
ConverterTag is a base class for all JSP custom actions that create and register a
Converter
instance on theValueHolder
associated with our most immediate surrounding instance of a tag whose implementation class is a subclass ofUIComponentTag
. To avoid creating duplicate instances when a page is redisplayed, creation and registration of aConverter
occurs only if the correspondingUIComponent
was created (by the owningUIComponentTag
) during the execution of the current page.This class may be used directly to implement a generic converter registration tag (based on the converter-id specified by the
converterId
attribute), or as a base class for tag instances that support specificConverter
subclasses. ThisconverterId
attribute must refer to one of the well known converter-ids, or a custom converter-id as defined in afaces-config.xml
file.Subclasses of this class must implement the
createConverter()
method, which creates and returns aConverter
instance. Any configuration properties that specify behavior of thisConverter
must have been set by thecreateConverter()
method. Generally, this occurs by copying corresponding attribute values on the tag instance.This tag creates no output to the page currently being created. It is used solely for the side effect of
Converter
creation.- See Also:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class javax.servlet.jsp.tagext.TagSupport
id, pageContext
-
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
Constructors Constructor and Description ConverterTag()
Deprecated.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method and Description protected Converter
createConverter()
Deprecated.Create and return a newConverter
to be registered on our surroundingUIComponent
.int
doStartTag()
Deprecated.Create a new instance of the specifiedConverter
class, and register it with theUIComponent
instance associated with our most immediately surroundingUIComponentTag
instance, if theUIComponent
instance was created by this execution of the containing JSP page.void
release()
Deprecated.Release references to any acquired resources.void
setBinding(String binding)
Deprecated.Set the expression that will be used to create aValueExpression
that references a backing bean property of theConverter
instance to be created.void
setConverterId(String converterId)
Deprecated.Set the identifer of theConverter
instance to be created.-
Methods inherited from class javax.servlet.jsp.tagext.TagSupport
doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
-
-
-
-
Method Detail
-
setConverterId
public void setConverterId(String converterId)
Deprecated.Set the identifer of the
Converter
instance to be created.- Parameters:
converterId
- The identifier of the converter instance to be created.
-
setBinding
public void setBinding(String binding) throws JspException
Deprecated.Set the expression that will be used to create a
ValueExpression
that references a backing bean property of theConverter
instance to be created.- Parameters:
binding
- The new expression- Throws:
JspException
- if a JSP error occurs
-
doStartTag
public int doStartTag() throws JspException
Deprecated.Create a new instance of the specified
Converter
class, and register it with theUIComponent
instance associated with our most immediately surroundingUIComponentTag
instance, if theUIComponent
instance was created by this execution of the containing JSP page. If the localValue of theUIComponent
is a String, attempt to convert it.- Specified by:
doStartTag
in interfaceTag
- Overrides:
doStartTag
in classTagSupport
- Returns:
- SKIP_BODY
- Throws:
JspException
- if a JSP error occurs- See Also:
Tag.doStartTag()
-
release
public void release()
Deprecated.Release references to any acquired resources.
- Specified by:
release
in interfaceTag
- Overrides:
release
in classTagSupport
- See Also:
Tag.release()
-
createConverter
protected Converter createConverter() throws JspException
Deprecated.Create and return a new
Converter
to be registered on our surroundingUIComponent
.- Throws:
JspException
- if a new instance cannot be created
-
-
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/convertertag.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.