Configurer un projet Java EE avec eclipse

Jean-Yves Didier

Objectifs :
— Personnaliser l’installation standard d’Eclipse ;
— Démarrer un projet Java EE ;
— Lancer un serveur Java EE avec une application web fonctionnelle.

Table des matières

1 Télécharger les modules Java EE 2

2 Télécharger ApacheTomcat 3

3 Configurer un serveur pour tester Java EE 3

4 Créer un projet web 4

5 Tester le service web 5

6 Ecrire une première servlet 6

1
Eclipse, dans sa version de base, ne contient pas les modules pour faire fonctionner Java EE. Nous
allons, dans un premier temps, forcer Eclipse à télécharger ces modules, puis, nous allons le pa-
ramétrer pour pouvoir tester et exécuter des projets Java EE.

1 Télécharger les modules Java EE

1. Lancer eclipse ;
2. Dans le menu Help, sélectionner l’option Install New Software ;
3. Une boı̂te de dialogue s’affiche alors (Fig. 1) ;
4. Dans Work with :, sélectionner l’option Luna - http ://download.eclipse.org/releases/luna 1 ;
5. Laisser zone centrale blanche se peupler avec la liste des extensions (Fig. 2) ;
6. Cocher Web, XML, Java EE and OSGi Entreprise Development et cliquer sur le bouton Next
en bas, puis encore une fois sur l’écran suivant, accepter les conditions de la licence et cliquer
sur le bouton Finish en bas.
7. Laisser l’installation des extensions s’effectuer et accepter de redémarrer eclipse lorsque le
processus est terminé.

F IGURE 1 – Boı̂te de dialogue pour télécharger des extensions pour Eclipse

1. Luna est le nom d’une version d’eclipse. A l’UFR S&T, une autre version existe dans certaines salles, il s’agit
d’Indigo. Dans ce cas, il faudra remplacer par le nom de version approprié.

2
 F IGURE 2 – Boı̂te de dialogue pour télécharger des extensions pour Eclipse

2 Télécharger ApacheTomcat
Apache Tomcat est un conteneur pour servlet. Il permet de les lire et de les exécuter. Pour télécharger
Apache Tomcat, vous devez vous rendre sur le site Web suivant : http ://tomcat.apache.org et télécharger
une archive zip de la version 7 pour Windows en 32 bits. Vous pourrez la décompresser, par exemple
sur le bureau.

3 Configurer un serveur pour tester Java EE

Java EE permet d’écrire des applications web. En tant que tel, vous devrez avoir un service web
vous permettant de servir les pages produites par Java EE. La procédure ci-dessous vous permet de
configurer un serveur web pour vos besoins.
1. Dans le menu File, sélectionner le sous-menu New, puis l’option Other... ;
2. Un assistant s’ouvre. Sélectionner Server et l’option Server, puis cliquer sur le bouton Next
situé en bas (Fig. 3) ;
3. Dans la nouvelle liste produite, sélectionner Apache et l’option Tomcat v7.0 Server, puis cli-
quer sur le bouton Finish situé en bas.

3
 F IGURE 3 – Assistant pour configurer un serveur

Une fois ces actions effectuées, il faudra préciser à Eclipse où se situe la version de Tomcat que
vous avez installée. Vous devrez donc :
1. Aller dans le menu Window et sélectionner l’option Preferences ;
2. Dans la fenêtre qui s’affiche, vous déplierez le menu Server à droite et sélectionnerez l’option
Runtime Environment ;
3. A droite s’affiche une liste des serveurs créés. Sélectionnez Apache tomcat v7.0, puis cliquez
sur le bouton Edit... ;
4. Dans la fenêtre qui s’affiche, paramétrez le chemin où vous avez décompressé Tomcat ainsi
que la version du JRE que vous souhaitez installer ;
5. Une fois cette étape réalisée, cliquer sur le bouton Finish, puis fermer la fenêtre des préférences.

4 Créer un projet web

Une fois le service web mis en place, nous allons pouvoir créer un site web dynamique, utilisant
les fonctionnalités de Java EE.
A ce stade, il est recommandé de travailler avec la perspective Java EE préconfigurée dans Eclipse.
Pour l’activer, vous pouvez le faire en cliquant sur le bouton Java EE situé en haut à droite.
Les étapes pour créer une application web sont les suivantes :
1. Dans le menu File, sélectionner le sous-menu New, puis l’option Dynamic Web Project ;
2. Une boı̂te de dialogue s’ouvre dans laquelle vous allez pouvoir paramétrer le nom de votre pro-
jet (en haut, champ nommé Project Name), utiliser comme cible d’exécution (Target runtime)
le serveur que vous venez de créer, à savoir Tomcat v7.0 Server, puis vous pourrez cliquer sur
le bouton Finish, situé en bas (Fig. 4).

4
 F IGURE 4 – Boite de dialogue pour créer un projet de site web dynamique

5 Tester le service web

Pour vérifier que l’installation fonctionne bien, nous allons ajouter une page web statique à notre
application puis faire en sorte de pouvoir l’exécuter. Les étapes pour le réaliser sont les suivantes :
1. Dans le menu File, sélectionner le sous-menu New, puis l’option Other.... Sélectionner, dans
l’assistant Web, puis HTML File ;
2. Dans la nouvelle page de l’assistant, sélectionner le dossier WebContent de votre projet, puis
donner un nom à votre page web et enfin cliquer sur le bouton Finish situé en bas ;
3. Editer la page web de manière à ce qu’elle affiche un message personnalisé ;
4. Une fois la page modifièe, faire un clic droit sur cette dernière dans l’arborescence du projet,
sélectionner le sous-menu Run As puis l’option Run on Server ;
5. Dans l’assistant, sélectionner le serveur que vous avez précédemment configuré, à savoir Tom-
cat v7.0 Server at localhost et cliquer sur le bouton Finish ;
6. Sous Eclipse, votre page web devrait s’afficher, telle que générée par le service (Fig. 5).

Remarque : L’adresse affichée en haut de la zone centrale peut-être recopiée sous Firefox aussi.
Vous aurez accès à intégralement la même page web.

5
 F IGURE 5 – Zone centrale affichant la page web produite

6 Ecrire une première servlet

Les servlets sont des applications écrites en Java dont le code génère du contenu pour un site ou
un service Web. Dans le principe, une servlet est écrite puis déployée sur le service web visé.
Une servlet est créée de la même manière qu’une classe, en faisant un clic droit sur le projet,
sélectionnant le sous-menu New et l’option Servlet. A partir de ce moment, un assistant démarrera la
configuration de la servlet. Vous aurez essentiellement à préciser son nom.