Initiation aux facelets avec JavaServer Faces [20 mn de lecture - paru le 6/7/2006 4:12:44 PM - Public : Confirmé]

Auteur

Brice GAILLARD Elève-Ingénieur Supinfo Caraïbes Promotion SUPINFO 2007    Lui écrire    Tous les projets de cet auteur    Le mini-CV de cet auteur

1 Présentation de Facelets

1.1 Concepts généraux

Facelets utilise des pages bien formées en termes XML et utilise par défaut des pages XHTML. Il peut utiliser d’autres types de pages mais personnellement je n’ai pas réussi.

Le framework Facelets est basé sur la représentation de la page sous la forme d’un arbre. Cet arbre est composé avec des UIComponents.(composants JSF).

Les Facelets supportent tous les composants JSF comme les controllers, les validators, les converters et les render Kit.

1.2 Tag 'ui'

Facelets apporte une nouvelle librairie de tag ui (user interface) pour gérer les templates.
Les pages doivent déclarer le namespace xmlns:ui=http://java.sun.com/jsf/facelet pour utiliser les tags.

1.3 Elément 'jsfc'

Facelets propose un mécanisme permettant de convertir un élément XML en un autre à la compilation en utilisant l’attribut ‘jsfc’.

Le compilateur transformera le tag < input > en < h:inputText >

1.4 Templating

La notion fondamentale à comprendre pour utiliser Facelets est la notion de templates.
Dans les Facelets, il y a deux rôles, le template et le template client.

Est considéré comme template n’importe quel document contenant un ou plusieurs tags < ui:insert >. Ce tag permet d’ajouter des éléments dans l’arbre de création de la page.
Un document est considéré comme un template client lorsqu’il possède les tags < ui:composition >, < ui:component >, < ui:decorate > et < ui:fragment >. Leur utilisation est décrite plus bas.

Une page template client est basé sur la structure d’une page template et utilise le tag < ui:define > pour définir les composants qui seront injectés à l’endroit où est situé le tag < ui:insert > dans la page template.

Les templates sont gérés par un TemplateManager qui utilise une sorte de pile pour gérer les arbres de construction. Les templates peuvent être utilisés sur plusieurs niveaux, ce qui veut dire que les templates clients peuvent être utilisés comme template pour un autre template client. Le TemplateManager se charge de reconstruire la page.

• < ui:component > : ce tag permet de créer un nouveau UIComponent qui sera ajouter à l’arbre de création. Les éléments hors du tag sont supprimés lors de la compilation.
• < ui:composition > : ce tag permet de redéfinir un UIComponent tiré du template dans l’arbre de création. Les éléments hors du tag sont supprimés lors de la compilation.
• < ui:decorate > : s’utilise comme le tag < ui:composition > sauf qu’il ne supprime pas les éléments extérieurs dans la création de l’arbre.
• < ui:fragment > : s’utilise comme le tag < ui:component > sauf qu’il ne supprime pas les éléments extérieurs dans la création de l’arbre.
• ≶ ui:debug > : permet de définir des combinaisons de touches pour lancer une console de debug.
• < ui:define > : s’utilise parallèlement au tag pour modifier des composants dans un template client par rapport à ceux du template.
• ≶ ui:insert > : permet de définir une zone qui sera modifiable dans le template client.
• < ui:include > : comme le tag < jsp:include > permet d’inclure une autre page.
• < ui:param > : permet de spécifier un paramètre avec une page insérée.
• < ui:remove > : permet de supprimer une zone à la compilation.
• < ui:repeat > : permet d’itérer sur une variable JSF.