Déploiement d un web service SOAP sur Tomcat 26 Septembre 2016 L objectif de ce document est d expliquer comment créer sa première application distribuée composée d un serveur et d un client qui communiquent avec le protocole SOAP. Ce document explique : 1. Les outils à télécharger et installer pour développer et déployer une telle application. Nous travaillerons avec l IDE Eclipse et le langage java, 2. Les différentes étapes pour créer son propre service Web (utilisant SOAP) avec Eclipse et Tomcat, 3. Comment déployer l application en local et à distance (sur un serveur Tomcat)? 4. Comment invoquer le serveur à partir d un client python? Téléchargement des environnements de développement (Eclipse et Tomact) 1. Télécharger Eclipse IDE for Java EE Developers (Version Indigo) 2. Télécharger Tomcat 7 (http://tomcat.apache.org/download-70.cgi). Pour MAC, vous pouvez consulter ce lien YouTube : https://www.youtube.com/watch?v=wibj7tc5oge Création d un web service avec Eclipse et Tomcat 1. Dans Eclipse, créer un nouveau projet : New -> Project -> Web -> Dynamic Web Project 2. Nommez votre projet avec votre nom de famille (l idée est de différencier votre application vis à vis des autres, lorsque vous le déployez sur un serveur public/commun Tomcat). Dans le cas où vous créez votre web service pour la première fois, sous «Target runtime», 1
choisir «New Runtime» et spécifier le dossier Tomcat téléchargé au préalable pour le «Tomcat installation directory» 3. Créez une nouvelle classe dans src du package YOUR_NAME.com.web.service 4. Ecrire le code suivant dans votre fichier (ne pas oublier de sauvegarder le fichier, lors de la création du web service. Eclipse ne le sauvegarde pas automatiquement) public class HelloWorld { public String toupper (String s){ return s.touppercase(); public String tolower (String s){ return s.tolowercase(); 5. Lancer le web service : Clic droit sur le fichier classe qui vient d être créée. Sélectionnez le menu Web Services -> Create Web Service. 6. Modifier la scroll bar sous «Client type» pour générer un «Test client» (cf. capture d écran suivante). Ne pas oublier de cocher «Publish the Web service» & «Monitor the web service». 2
7. Arrivé à ce stade, Eclipse doit lancer le serveur Tomcat avec votre web service. Il doit aussi générer le client(family_nameclient). Lorsque l opération est achevée, Eclipse exécute le client. Le WSDL du service web déployé est disponible sur cet URL : http://localhost:8080/family_name/services/helloworld?wsdl (on suppose ici que le serveur Tomcat est déployé sur le port 8080. 3
8. On peut maintenant sélectionner les méthodes et les essayer. Par exemple tolower Déploiement du web service sur un serveur Tomcat Maintenant que le service est créé et testé en local, on peut l exporter et le déposer sur un serveur Tomcat pour pouvoir y accéder. 1. Dans Eclipse, sélectionner votre serveur SOAP (projet Eclipse) et exporter un fichier.war : Export -> Web -> WAR file 2. Aller sur le serveur Tomcat disponible sur cette adresse : gw-hepiacloud.hesge.ch:10172/manager/html (login : student, password : sdi2016) et déployer le.war -> WAR file to deploy -> votre fichier war -> Deploy. Une fois cette étape réalisée, vous pouvez voir votre web service dans la liste. Votre wsdl est disponible sur ce lien : gwhepiacloud.hesge.ch:10172/family_name/services/helloworld?wsdl 3. Vous pouvez aussi générer automatiquement un client via le web (par exemple http://www.service-repository.com/client/start) en lui fournissant l adresse URL du wsdl 4. Il est possible d invoquer ce service via la commande curl. Pour le faire, il faut créer une enveloppe soap avec la méthode à invoquer et l envoyer. Exemple : Enveloppe soap qui invoque la méthode tolower sur le texte «LOWER ME PLEASE» : 4
<soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <soapenv:body> <tolower xmlns="http://service.web.com.abdennhader"> <s>lower ME PLEASE</s> </tolower> </soapenv:body> </soapenv:envelope> Ensuite, la commande curl à envoyer est la suivante : curl --header "Content-Type:text/xml;charset=utf-8" --header "SOAPAction:toLower" --data @SOAP_ENVELOPE_FILENAME http://gwhepiacloud.hesge.ch:10172/ FAMILY_NAME /services/helloworld Client python soap Il est aussi possible d écrire un client python pour le même serveur Java développé précédemment. De nombreuses librairies existent, par exemple, suds. 1. Installation de suds : sudo pip install suds 2. Le client est très simple à écrire : import suds url = "http://gwhepiacloud.hesge.ch:10172/family_name/services/helloworld?wsdl" client = suds.client.client(url) print client # Print info about invokable methods print client.service.tolower ("LOWER ME") print client.service.toupper ("make me bigger"); print client.last_received() # Print last content received in xml 5