javax.faces.convert

Annotation Type FacesConverter

Table des matières

  • @Retention(value=RUNTIME)
 @Target(value=TYPE)
 @Inherited
public @interface FacesConverter

    The presence of this annotation on a class automatically registers the class with the runtime as a Converter. The value of the value() attribute is taken to be converter-id, the value of the forClass() attribute is taken to be converter-for-class and the fully qualified class name of the class to which this annotation is attached is taken to be the converter-class. The implementation must guarantee that for each class annotated with FacesConverter, found with the algorithm in section JSF.11.5, the proper variant of Application.addConverter() is called. If converter-id is not the empty string, Application.addConverter(java.lang.String,java.lang.String) is called, passing the derived converter-id as the first argument and the derived converter-class as the second argument. If converter-id is the empty string, Application.addConverter(java.lang.Class,java.lang.String) is called, passing the converter-for-class as the first argument and the derived converter-class as the second argument. The implementation must guarantee that all such calls to addConverter() happen during application startup time and before any requests are serviced.

    The preceding text contains an important subtlety which application users should understand. It is not possible to use a single @FacesConverter annotation to register a single Converter implementation both in the by-class and the by-converter-id data structures. One way to achieve this result is to put the actual converter logic in an abstract base class, without a @FacesConverter annotation, and derive two sub-classes, each with a @FacesConverter annotation. One sub-class has a value attribute but no forClass attribute, and the other sub-class has the converse.

    Please see the ViewDeclarationLanguage documentation for <h:selectManyListBox> for another important subtlety regarding converters and collections.

      • forClass

        public abstract Class forClass

        The value of this annotation attribute is taken to be the converter-for-class with which instances of this class of converter can be instantiated by calling Application.createConverter(java.lang.Class).

        Default:
        java.lang.Object.class

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 14:34:23 Cette version de la page est en cache (à la date du 21/08/2025 14:34:23) 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 11/06/2005, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/faces/convert/FacesConverter.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

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, FacesConverter (Java(TM) EE 7 Specification APIs)

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.