Cration dun web service sous Eclipse/Tomcat

tutorial version 2 pour Windows

2
2
3

Tlchargement et mise en place des outils

Dossiers dinstallation
Configuration dEclipse avec Tomcat/Axis

4
4
5

Dveloppement Web Service

Cration du code mtier
Cration du Web Service

6
7
8

Configuration du Web Service

Lancement du Web Service
Test du Web Service avec le Web Service Explorer

9
10
11

Partie Cliente
Cration de la classe principale
Appel du service

12
12
13
14
15

Deploiement du Web Service

Export WAR
Configuration du serveur Apache Tomcat autonome.
Vrification de la prsence du service
Export du client et test final

David Durand - D314 : Web Services

Tlchargement et mise en place des outils

La ralisation de ce projet de Web-Service repose sur lutilisation de trois outils :
LIDE Eclipse Galileo J2EE : http://eclipse.org/downloads/
La version standard peut galement tre utilise, mais elle ncessite linstallation de plugins supplmentaires (Eclipse WTP http://www.eclipse.org/webtools/releases/3.1.1/ )
Le serveur dapplications Apache Tomcat 6.
La version actuelle est disponible ladresse http://tomcat.apache.org/download-60.cgi (prendre la version zip)
Le moteur de Web-services Apache Axis2, version 1.5.1 Release
http://ws.apache.org/axis2/download/1_5_1/download.cgi (prendre la version WAR)

Dossiers dinstallation
Aprs dcompression des archives tlcharges, on considre
les dossiers de travail suivants :
c:\david : rpertoire de travail principal
c:\david\workspace_WS : dossier des projets Eclipse;
c:\david\apache-tomcat-6.0.20 : dossier dinstallation de
Tomcat
c:\david\axis2-1.5.1 : dossier dinstallation dAxis

Ces noms de dossiers sont adapter selon le systme utilis.

David Durand - D314 : Web Services

Configuration dEclipse avec Tomcat/Axis

Dans la fentre de prfrence dEclipse, configurer la partie Serveur et Web Services comme sur la figure suivante :

David Durand - D314 : Web Services

Dveloppement Web Service

Cration du code mtier
Lapproche Bottom-up consiste partir dun code existant pour lexposer en tant que Web-Service. On cre ici un simple projet Java nomm LibrairieMath, dans lequel on ajoute une
classe math.Math :

David Durand - D314 : Web Services

Cration du Web Service

A partir de la classe math.Math, utiliser le menu contextuel pour gnrer le Web Service associ. Un nouveau projet WS_exemple1_start sera cr :

David Durand - D314 : Web Services

Configuration du Web Service

Lassistant vous propose ensuite de slectionner les mthodes exposes par le Web-Service. Dans notre exemple, nous navons quune seule mthode :

David Durand - D314 : Web Services

Lancement du Web Service

A ltape suivante, lassistant vous propose de dmarrer le serveur Tomcat configur dans Eclipse. il est possible que votre systme ou votre pare-feu vous demande lautorisation de
dmarrer un logiciel qui coute sur un port. Aprs confirmation et fermeture de lassistant, le serveur Tomcat est dmarr dans Eclipse :

David Durand - D314 : Web Services

Test du Web Service avec le Web Service Explorer

Dans le projet gnr, utiliser le menu contextuel sur le fichier Math.wsdl tester le service. Un formulaire vous est propos pour appeler la mthode add, en lui passant des paramtres.
Aprs soumission du formulaire, le rsultat saffiche dans la fentre de statut.

David Durand - D314 : Web Services

Partie Cliente
Nous crons maintenant dans un projet spar le code client utilis pour lappel au service. Toujours laide du menu contextuel utilis sur Math.wsdl, gnrer le client comme sur la figure
suivante, sans oublier de prciser le nom du projet :

David Durand - D314 : Web Services

Cration de la classe principale

Dans le projet nouvellement cr, ajouter une classe Java. Dans le code suivant, MathServiceLocator est un objet vous mettant en relation avec le service math.Math . Il contient entre autre
ladresse utilise pour localiser le service. Sa mthode getMath() renvoie un proxy vers le service, qui va se charger de lui transmettre les appels.

David Durand - D314 : Web Services

10

Appel du service
Lancer la classe MainClient nouvellement cre. Le rsultat de lopration saffiche dans la console. (Ne pas tenir compte des messages davertissement signalant labsence de certaines
librairies, nous nen avons pas besoin)

David Durand - D314 : Web Services

11

Deploiement du Web Service

Pour le moment, tout a t test dans Eclipse, il sagit maintenant de tester notre service dans un serveur autonome.

Export WAR
Slectionner le dossier racine du projet Web Service, et utiliser le menu contextuel pour Exporter... sous la forme dune Web Archive. Choisissez le dossier webapps de tomcat pour
enregistrer larchive.

David Durand - D314 : Web Services

12

Configuration du serveur Apache Tomcat autonome.

Pensez arrter le serveur Tomcat dEclipse avant les prochaines tapes. Configurez - si ce nest pas dj fait - la variable denvironnement systme JRE_HOME pour quelle pointe sur le
dossier dinstallation de votre JRE. Tomcat a besoin de cette variable pour dmarrer :

David Durand - D314 : Web Services

13

Vrification de la prsence du service

Au dmarrage de Tomcat, celui-ci a automatiquement charg le fichier WAR prsent dans son dossier webapps. On doit donc pouvoir tester le service directement dans le navigateur, en
utilisant une adresse de la forme http://www.localhost:8080/NOM_DU_PROJET/services/Math
Il est galement possible de tester directement lappel dune mthode de notre service partir de la barre dadresse. On obtient alors la rponse SOAP contenant le rsultat.

David Durand - D314 : Web Services

14

Export du client et test final

Dans Eclipse, exporter le projet client de manire obtenir un JAR excutable. Excutez enfin le fichier JAR obtenu pour tester le service

David Durand - D314 : Web Services

15