I. Introduction▲
Les environnements de développement modernes (Eclipse, netbeans, etc.) offrent des outils sophistiqués permettant d'assister les développeurs dans leur travail et de leur simplifier les tâches manuelles ou bavardes (la configuration par fichiers XML par exemple).
Avec la sortie d'Eclipse Web Tools Project 2 (WTP), Eclipse offre aux développeurs travaillant avec JSF une suite d'outils graphiques permettant de simplifier et accélérer le développement.
Par exemple, WTP 2 offre :
- un éditeur graphique du fichier faces-config.xml (gestion des managed beans, des navigation rules, etc.) ;
- un éditeur de pages web semi-wysiwyg (palette de composants, property sheets, etc.) ;
- etc.
Cependant, pour pouvoir utiliser WTP2, il faut d'abord le configurer en définissant les implémentations JSF ou encore les serveurs où sera déployée l'application.
C'est dans ce cadre-là que s'inscrit ce tutoriel, où il s'agit de montrer pas à pas comment configurer WTP2 ainsi que comment créer son premier projet JSF.
II. Prérequis▲
II-A. Eclipse▲
Il vous faut Eclipse IDE for JavaEE Developers (3.3.1.1) qui est disponible en téléchargement libre et gratuit à cette adresse :
http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/20071103/eclipse-jee-europa-fall2-win32.zip
II-B. Web Tools project 2▲
Web Tools project est disponible en téléchargement libre et gratuit à cette adresse:
http://download.eclipse.org/webtools/downloads/
N.B. La version JavaEE d'Eclipse inclut déjà webtools.
Assurez-vous d'utiliser Web Tools Project 2.0.1 ou plus récent qui adresse de sérieux problèmes présents dans la version 2.0.
II-C. Une implémentation JSF▲
JSF n'est qu'une spécification faisant partie de Java EE. Pour pouvoir travailler avec, il vous faut une implémentation.
Voici quelques implémentations JSF gratuites et libres :
- Sun JSF 1.2 RI : https://javaserverfaces.dev.java.net/download.html;
- Apache MyFaces 1.2.0: http://myfaces.apache.org/download.html.
La RI de Sun (deux fichiers Jar) ne contient pas une implémentation JSTL qui est nécessaire à son fonctionnement. Vous devez télécharger une implémentation JSTL vous-même.
Pour vous simplifier la tâche, vous pouvez télécharger l'archive suivant qui contient l'implémentation Sun JSF 1.2 RI ainsi que toutes ses dépendances.
III. Configuration d'Eclipse Web Tools 2▲
La configuration de Web Tools ou plus précisément JSF Tools passe par les étapes suivantes :
- Dans Eclipse, ouvrir le menu Window, Preferences ;
- Dans la boite de dialogue qui s'affiche, à gauche, naviguez dans l'arbre des options jusqu'à Web and XML, JavaServer Faces Tools, Libraries ;
- Dans la vue qui s'affiche (à droite), cliquez sur le bouton New ;
- Entrez un nom (Sun JSF RI 1.2 par exemple) ;
- Sélectionnez 1.2 dans version supported ;
- Dans le volet Library Jars, cliquez sur le bouton Add ;
- Dans la boite de dialogue qui s'affiche, naviguez jusqu'aux fichiers jar de l'implémentation JSF (ainsi que ses dépendances) ;
- Validez.
Vous pouvez suivre le déroulement des étapes dans la démo Flash suivante :
Cliquez pour lire la vidéo
Dans le but de simplifier les choses, et comme le montre la démo précédente, j'ai inclus tous les fichiers jar de l'implémentation JSF ainsi que ses dépendances dans une seule bibliothèque. Mais en général, mieux vaut les séparer dans plusieurs bibliothèques.
Par exemple, dans ce cas de figure, il aurait été préférable de créer trois bibliothèques : une pour JSF RI, une autre pour JSTL et une dernière pour les fichiers jar de Jakarta commons.
IV. Création d'un projet JSF▲
Une fois WebTools configuré, vous pouvez créer des projets JSF. Pour ce faire, il faut :
- Dans Eclipse, ouvrir le menu File, New Project, Other ;
- Dans la boite de dialogue qui s'affiche, sélectionnez Dynamic Web Project et cliquez sur Next ;
- Entrez un nom pour le projet ;
- Nous n'avons pas encore défini de serveur où l'on exécutera nos projets JSF. Pour ce faire, cliquez sur le bouton New à droite de Target Runtime ;
- Dans la fenêtre qui s'affiche, sélectionnez le type du serveur (Tomcat par exemple) et validez ;
- Eclipse vous demandera ensuite de spécifier l'emplacement du serveur sélectionné. Cliquez sur Browse et naviguez jusqu'au répertoire d'installation du serveur et validez ;
- Dans la liste déroulante Configurations, sélectionnez JavaServer Face v1.2 Project et cliquez sur Next ;
- Dans la page suivante, vous pouvez configurer les versions des composants du projet comme la version de Java, de web.xml et de JSF. Cliquez sur Next ;
- La page suivante permet de changer le nom des dossiers source et WebContent. Cliquez sur Next ;
- La dernière page permet de spécifier l'implémentation JSF. Sélectionnez celle qu'on a créée précédemment et Validez. Assurez-vous que la case à cocher Deploy est active.
Vous pouvez suivre le déroulement des étapes dans la démo Flash suivante :
Cliquez pour lire la vidéo
V. Remerciements▲
Mes remerciements les plus sincères vont à :
- denisCProfil de denisC pour son aide et ses conseils ;
- vbrabantProfil de vbrabant pour ses conseils à propos des démos ;
- Ricky81Profil de Ricky81 pour ses encouragements ;
- RideKickProfil de RideKick pour sa relecture.