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

2 Utilisation de Facelets dans JSF

2.1 Installation

Pour installer Facelets dans une application JSF, il faut d’abord télécharger le projet à l’adresse https://facelets.dev.java.net/ . Le projet contient les sources, les librairies pré compilées, la documentation et des exemples. Le projet contient les librairies jsf-facelets.jar, el-ri.jar, el-api.jar, qui sont nécessaires pour permettre le support de Facelet.

Facelets fonctionne avec les versions 1.1 et 1.2 de l’implémentation Sun de JavaServer Faces et avec MyFaces l’implémentation de Apache de JSF. Facelets s’appuie aussi sur SAX pour lire les documents, c’est pourquoi les pages doivent être bien formées, avec une syntaxe XML.

Un projet JSF avec Facelets doit avoir cette structure :

Le fichier web.xml qui est le descripteur de déploiement.
Le fichier faces-config.xml pour la configuration de JSF
Les librairies facelet et les librairies jsf.

2.2 Configuration de JSF

Pour ajouter Facelets à l’application, en plus d’ajouter les librairies, il faut configurer le descripteur de déploiement web.xml et le fichier faces-config.xml.

Configuration de web.xml :

On peut ajouter plusieurs paramètres :

• facelets.DEVELOPMENT : true ou false, définit si le framework affiche les erreurs pour debug.
• facelets.REFRESH_PERIOD : intervalle en seconde pendant lequel le compilateur vérifie les changements effectués sur les pages.
• facelets.BUFFER_SIZE : le buffer size de la réponse générée par ResponseWriter.
• facelets.LIBRARIES : liste des tags librairies créées par l’utilisateur à ajouter au contexte.
• facelets.DECORATORS liste des tags decorateurs créées par l’utilisateur à ajouter au contexte.
• facelets.RESOURCE_RESOLVER : un ResourceResolver pour remplacer celui par défaut.
• facelets.VIEW_MAPPINGS : liste des ressources utilisable par l’application.
• facelets.SKIP_COMMENTS : true ou false, définit si le compilateur doit tenir compte des commentaires.

Ci-dessous un exemple de fichier web.xml :

Configuration de faces-config.xml

Les JavaServer Faces sont extrêmement interopérables avec d’autres frameworks. Les applications JSF comportent un certain nombre de modules nécessaire à son fonctionnement, qui peuvent être réécrites. Facelets est une implémentation du ViewHandler de JSF qui gère l’affichage des pages, redéfinie dans la classe com.sun.facelets.FaceletViewHandler.
Il faut ajouter le paramètre com.sun.facelets.FaceletViewHandler

Ci-dessous un exemple de fichier faces-config.xml