Création d un web service sous Eclipse/Tomcat tutorial version 2 pour Windows

Transcription

1 Création d un web service sous Eclipse/Tomcat tutorial version 2 pour Windows Téléchargement et mise en place des outils 2 Dossiers d installation 2 Configuration d Eclipse avec Tomcat/Axis 3 Développement Web Service 4 Création du code métier 4 Création du Web Service 5 Configuration du Web Service 6 Lancement du Web Service 7 Test du Web Service avec le Web Service Explorer 8 Partie Cliente 9 Création de la classe principale 10 Appel du service 11 Deploiement du Web Service 12 Export WAR 12 Configuration du serveur Apache Tomcat autonome. 13 Vérification de la présence du service 14 Export du client et test final 15 David Durand - D314 : Web Services 1

2 Téléchargement et mise en place des outils La réalisation de ce projet de Web-Service repose sur l utilisation de trois outils : L IDE Eclipse Galileo J2EE : La version standard peut également être utilisée, mais elle nécessite l installation de plugins supplémentaires (Eclipse WTP ) Le serveur d applications Apache Tomcat 6. La version actuelle est disponible à l adresse (prendre la version zip) Le moteur de Web-services Apache Axis2, version Release (prendre la version «WAR») Dossiers d installation Après décompression des archives téléchargées, on considère les dossiers de travail suivants : c:\david : répertoire de travail principal c:\david\workspace_ws : dossier des projets Eclipse; c:\david\apache-tomcat : dossier d installation de Tomcat c:\david\axis : dossier d installation d Axis Ces noms de dossiers sont à adapter selon le système utilisé. David Durand - D314 : Web Services 2

3 Configuration d Eclipse avec Tomcat/Axis Dans la fenêtre de préférence d Eclipse, configurer la partie Serveur et Web Services comme sur la figure suivante : David Durand - D314 : Web Services 3

4 Développement Web Service Création du code métier L approche Bottom-up consiste à partir d un code existant pour l exposer en tant que Web-Service. On crée ici un simple projet Java nommé LibrairieMath, dans lequel on ajoute une classe math.math : David Durand - D314 : Web Services 4

5 Création du Web Service A partir de la classe math.math, utiliser le menu contextuel pour générer le Web Service associé. Un nouveau projet «WS_exemple1_start» sera créé : David Durand - D314 : Web Services 5

6 Configuration du Web Service L assistant vous propose ensuite de sélectionner les méthodes exposées par le Web-Service. Dans notre exemple, nous n avons qu une seule méthode : David Durand - D314 : Web Services 6

7 Lancement du Web Service A l étape suivante, l assistant vous propose de démarrer le serveur Tomcat configuré dans Eclipse. il est possible que votre système ou votre pare-feu vous demande l autorisation de démarrer un logiciel qui écoute sur un port. Après confirmation et fermeture de l assistant, le serveur Tomcat est démarré dans Eclipse : David Durand - D314 : Web Services 7

8 Test du Web Service avec le Web Service Explorer Dans le projet généré, utiliser le menu contextuel sur le fichier Math.wsdl tester le service. Un formulaire vous est proposé pour appeler la méthode add, en lui passant des paramètres. Après soumission du formulaire, le résultat s affiche dans la fenêtre de statut. David Durand - D314 : Web Services 8

9 Partie Cliente Nous créons maintenant dans un projet séparé le code client utilisé pour l appel au service. Toujours à l aide du menu contextuel utilisé sur Math.wsdl, générer le client comme sur la figure suivante, sans oublier de préciser le nom du projet : David Durand - D314 : Web Services 9

10 Création 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 l adresse utilisée pour localiser le service. Sa méthode getmath() renvoie un proxy vers le service, qui va se charger de lui transmettre les appels. David Durand - D314 : Web Services 10

11 Appel du service Lancer la classe MainClient nouvellement créée. Le résultat de l opération s affiche dans la console. (Ne pas tenir compte des messages d avertissement signalant l absence de certaines librairies, nous n en avons pas besoin) David Durand - D314 : Web Services 11

12 Deploiement du Web Service Pour le moment, tout a été testé dans Eclipse, il s agit maintenant de tester notre service dans un serveur autonome. Export WAR Sélectionner le dossier racine du projet Web Service, et utiliser le menu contextuel pour Exporter... sous la forme d une Web Archive. Choisissez le dossier webapps de tomcat pour enregistrer l archive. David Durand - D314 : Web Services 12

13 Configuration du serveur Apache Tomcat autonome. Pensez à arrêter le serveur Tomcat d Eclipse avant les prochaines étapes. Configurez - si ce n est pas déjà fait - la variable d environnement système JRE_HOME pour qu elle pointe sur le dossier d installation de votre JRE. Tomcat a besoin de cette variable pour démarrer : David Durand - D314 : Web Services 13

14 Vérification de la présence du service Au démarrage de Tomcat, celui-ci a automatiquement chargé le fichier WAR présent dans son dossier webapps. On doit donc pouvoir tester le service directement dans le navigateur, en utilisant une adresse de la forme Il est également possible de tester directement l appel d une méthode de notre service à partir de la barre d adresse. On obtient alors la réponse SOAP contenant le résultat. David Durand - D314 : Web Services 14

15 Export du client et test final Dans Eclipse, exporter le projet client de manière à obtenir un JAR exécutable. Exécutez enfin le fichier JAR obtenu pour tester le service David Durand - D314 : Web Services 15