All Known Implementing Classes:

BigDecimalConverter, BigIntegerConverter, BooleanConverter, ByteConverter, CharacterConverter, DateTimeConverter, DoubleConverter, EnumConverter, FloatConverter, IntegerConverter, LongConverter, NumberConverter, ShortConverter
```
public interface Converter
```
Converter is an interface describing a Java class that can perform Object-to-String and String-to-Object conversions between model data objects and a String representation of those objects that is suitable for rendering.

Converter implementations must have a zero-arguments public constructor. In addition, if the Converter class wishes to have configuration property values saved and restored with the component tree, the implementation must also implement StateHolder.

Starting with version 1.2 of the specification, an exception to the above zero-arguments constructor requirement has been introduced. If a converter has a single argument constructor that takes a Class instance and the Class of the data to be converted is known at converter instantiation time, this constructor must be used to instantiate the converter instead of the zero-argument version. This enables the per-class conversion of Java enumerated types.

If any Converter implementation requires a java.util.Locale to perform its job, it must obtain that Locale from the UIViewRoot of the current FacesContext, unless the Converter maintains its own Locale as part of its state.

If the class implementing Converter has a ResourceDependency annotation, the action described in ResourceDependency must be taken when ValueHolder.setConverter(javax.faces.convert.Converter) is called. If the class implementing Converter has a ResourceDependencies annotation, the action described in ResourceDependencies must be taken when ValueHolder.setConverter(javax.faces.convert.Converter) is called.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE_PARAM_NAME` If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, Application.createConverter() must guarantee that the default for the timezone of all javax.faces.convert.DateTimeConverter instances must be equal to TimeZone.getDefault() instead of "GMT".

Retour à la première page de API Java Table des matières Haut

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`Object`	`getAsObject(FacesContext context, UIComponent component, String value)` Convert the specified string value, which is associated with the specified `UIComponent`, into a model data object that is appropriate for being stored during the Apply Request Values phase of the request processing lifecycle.
`String`	`getAsString(FacesContext context, UIComponent component, Object value)` Convert the specified model object value, which is associated with the specified `UIComponent`, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle.

Retour à la première page de API Java Table des matières Haut

- Field Detail
  - DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE_PARAM_NAME
```
static final String DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE_PARAM_NAME
```
    If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, Application.createConverter() must guarantee that the default for the timezone of all javax.faces.convert.DateTimeConverter instances must be equal to TimeZone.getDefault() instead of "GMT".
    
    Since:
    
    2.0
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getAsObject
```
Object getAsObject(FacesContext context,
                   UIComponent component,
                   String value)
```
    Convert the specified string value, which is associated with the specified UIComponent, into a model data object that is appropriate for being stored during the Apply Request Values phase of the request processing lifecycle.
    
    Parameters:
    
    context - FacesContext for the request being processed
    
    component - UIComponent with which this model object value is associated
    
    value - String value to be converted (may be null)
    
    Returns:
    
    null if the value to convert is null, otherwise the result of the conversion
    
    Throws:
    
    ConverterException - if conversion cannot be successfully performed
    
    NullPointerException - if context or component is null
  - getAsString
```
String getAsString(FacesContext context,
                   UIComponent component,
                   Object value)
```
    Convert the specified model object value, which is associated with the specified UIComponent, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle.
    
    Parameters:
    
    context - FacesContext for the request being processed
    
    component - UIComponent with which this model object value is associated
    
    value - Model object value to be converted (may be null)
    
    Returns:
    
    a zero-length String if value is null, otherwise the result of the conversion
    
    Throws:
    
    ConverterException - if conversion cannot be successfully performed
    
    NullPointerException - if context or component is null

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Version en cache

21/08/2025 19:03:08 Cette version de la page est en cache (à la date du 21/08/2025 19:03:08) afin d'accélérer le traitement.
Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.

Document créé le 14/04/2008, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/faces/convert/converter.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : https://docs.oracle.com, Converter

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Interface Converter

Field Summary

Method Summary

Field Detail

DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE_PARAM_NAME

Method Detail

getAsObject

getAsString

Références