Configuration d'Eclipse Webtools 2 pour JSF

Jawher Moussa

Cet article a pour objectif de vous guider dans les tâches de configuration d'Eclipse Web Tools 2 pour travailler avec JavaServer Faces (JSF).

- Titre : Configuration d'Eclipse Webtools 2 pour JSF

- Auteur : Jawher Moussa

- Parution : 10 décembre 2007

- Mise à jour : 16 février 2020

- Licence : Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright ® 2007 djo.mos. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Introduction

- II. Prérequis

- II-A. Eclipse

- II-B. Web Tools project 2

- II-C. Une implémentation JSF

- III. Configuration d'Eclipse Web Tools 2

- IV. Création d'un projet JSF

- V. Remerciements

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 :

1. Dans Eclipse, ouvrir le menu Window, Preferences ;

2. Dans la boite de dialogue qui s'affiche, à gauche, naviguez dans l'arbre des options jusqu'à Web and XML, JavaServer Faces Tools, Libraries ;

3. Dans la vue qui s'affiche (à droite), cliquez sur le bouton New ;

4. Entrez un nom (Sun JSF RI 1.2 par exemple) ;

5. Sélectionnez 1.2 dans version supported ;

6. Dans le volet Library Jars, cliquez sur le bouton Add ;

7. Dans la boite de dialogue qui s'affiche, naviguez jusqu'aux fichiers jar de l'implémentation JSF (ainsi que ses dépendances) ;

8. Validez.

Vous pouvez suivre le déroulement des étapes dans la démo Flash suivante :

Animation en format "flash" non supportée.
Contenu uniquement consultable en ligne à cette adresse :
wtp-jsf-intro.swf

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 :

1. Dans Eclipse, ouvrir le menu File, New Project, Other ;

2. Dans la boite de dialogue qui s'affiche, sélectionnez Dynamic Web Project et cliquez sur Next ;

3. Entrez un nom pour le projet ;

4. 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 ;

5. Dans la fenêtre qui s'affiche, sélectionnez le type du serveur (Tomcat par exemple) et validez ;

6. 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 ;

7. Dans la liste déroulante Configurations, sélectionnez JavaServer Face v1.2 Project et cliquez sur Next ;

8. 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 ;

9. La page suivante permet de changer le nom des dossiers source et WebContent. Cliquez sur Next ;

10. 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 :

Animation en format "flash" non supportée.
Contenu uniquement consultable en ligne à cette adresse :
wtp-jsf-intro-2.swf

V - Remerciements

Mes remerciements les plus sincères vont à :

- denisC pour son aide et ses conseils ;

- vbrabant pour ses conseils à propos des démos ;

- Ricky81 pour ses encouragements ;

- RideKick pour sa relecture.