Adolphe Francois Julien Marmel Dominique Perlat Olivier Printemps SOAP. Simple Object Access Protocol. Encadrant : Chantal Taconet

Transcription

1 Adolphe Francois Julien Marmel Dominique Perlat Olivier Printemps SOAP Simple Object Access Protocol Encadrant : Chantal Taconet

2 Sommaire Sommaire... 2 Première Partie : Présentation Générale de SOAP Présentation et fonctionnement SOAP Présentation et fonctionnement des Webservices Le protocole WSDL Le protocole UDDI Différence entre IIOP et SOAP Protocoles utilisés par SOAP Problèmes posés par SOAP :... 8 a) Problèmes HTTP... 8 b) Problèmes XML... 8 c) Problèmes liés à SOAP Les fichiers WSDL... 9 a) Services b) Port c) Message d) Port Type et Opérations e) Bindings Deuxième Partie : Installation et mise en œuvre Apache SOAP a) Installation b) Exemple d utilisation NuSoap a) Installation b) Exemples d utilisation SOAP::Lite a) Installation b) Exemple d utilisation : Tests d interoperabilité Troisième Partie : Exemples d utilisation Exemple de Web Service : Google Web Service Exemple du gestionnaire d imprimante a) Exemple 1 : l imprimante HP b) Exemple 2 : le gestionnaire d impression c) Exemple 3 : le gestionnaire d impression et WSDL d) Exécution des exemples Bibliographie SOAP Simple Access Protocol 2

3 Première Partie : Présentation Générale de SOAP 1. Présentation et fonctionnement SOAP SOAP (Simple Object Access Protocol) est un protocole d invocation de méthodes sur des services distants. Basé sur XML, SOAP est un format de communication pour assurer communication de machine à machine. Le protocole permet d appeler une méthode RPC (Remote Procedure Call) et d envoyer des messages aux machines distantes via HTTP. Ce protocole est très bien adapté à l utilisation des services web car il permet de fournir au client une grande quantité d informations récupérées sur un réseau de serveurs tiers. La version actuelle de SOAP est la 1.1. Cette version a été proposée au W3C en 2000 par UserLand, Ariba, Commerce One, Compaq, Developmentor, HP, IBM, IONA, Lotus, Microsoft, SAP. Le W3C travaille actuellement sur la version 1.2 de SOAP, elle devrait sortir fin 2002 et à pour but de supprimer l utilisation des RPC au profit des messages. SOAP permet donc l échange d information dans un environnement décentralisé et distribué, comme Internet par exemple. Il permet l invocation de méthodes, de services, de composants et d objets sur des serveurs distants et peut fonctionner sur de nombreux protocoles (des systèmes de messagerie à l utilisation de RPC). Cependant, il fonctionne particulièrement bien avec le protocole HTTP, protocole très souvent utilisé avec SOAP. SOAP utilise les protocoles HTTP et XML. HTTP comme mécanisme d invocation de méthodes en utilisant un des balises spécifiques pour indiquer la présence de SOAP comme «<SOAP-ENV>». Cela permet de franchir aisément les firewalls et proxy et facilite le traitement en cas de filtrage. XML pour structurer les requêtes et les réponses, indiquer les paramètres des méthodes, les valeurs de retours, et les éventuelles erreurs de traitements. XML joue un rôle prépondérant dans SOAP, on peut distinguer plusieurs éléments : une enveloppe, expliquant comment la requête doit être traitée et présentant les éléments contenus dans le message. un ensemble de règles de codage, permettant de différencier les types de données transmises. une convention de représentation, permettant de représenter les appels aux procédures de traitement et les réponses. Même si SOAP ressemble beaucoup en termes de fonctionnalités à des protocoles comme IIOP pour CORBA, ORPC pour DCOM, ou JRMP (Java Remote Method Protocol) pour JAVA, il possède un avantage indéniable. En effets, SOAP utilise un mode texte alors que les autres fonctionnent en mode binaire, cela facilite le passage des équipements de sécurité. SOAP Simple Access Protocol 3

4 2. Présentation et fonctionnement des Webservices Présentation : Les Webservices permettent de faire communiquer deux sous-systèmes ensembles et cela indépendamment des architectures utilisées. Ces systèmes vont pouvoir s échanger des services ou des traitements applicatifs. Les Webservices constituent un moyen de distribuer un service de manière standard grâce à XML tout en respectant un modèle de développement ayant déjà fait ses preuves comme CORBA ou DCOM (Microsoft). Un des avantages des Webservices est de regrouper tous les acteurs derrière un seul et même standard. Fonctionnement : Pour expliquer le fonctionnement des webservices, il convient de distinguer plusieurs étapes :! Recherche dans un annuaire UDDI : le client cherche un service particulier, il s adresse à un annuaire qui va lui fournir la liste des prestataires habilités à satisfaire sa demande. L annuaire UDDI peut être comparé à un moteur de recherche sauf que les documents sont remplacés par des services.! Recherche de l interface du composant à contacter : une fois la réponse reçue (en XML) de l annuaire, le client va chercher à communiquer via une interface. Cette interface décrite en langage WSDL fournit l ensemble des services disponibles. Elle offre la possibilité de vérifier que le contrat correspond bien aux besoins demandés.! Invocation du service : le client doit maintenant passer les paramètres attendus par le service et assurer la communication avec le serveur. L outil utilisé pour cela est le Proxy, c est l objet qui permet la communication entre le client et le serveur. Il est généré par le client en utilisant l interface WSDL. 3. Le protocole WSDL WSDL (Web Service Definition Langage) est un format de représentation des interfaces de services Web en XML. Une analogie avec CORBA peut être faite, en effet WSDL est la représentation XML du langage IDL (description d interfaces). WSDL a deux rôles prépondérants:! Il sert de référence à la génération de Proxies.! Il assure le couplage entre le client et le serveur par le biais des interfaces. 4. Le protocole UDDI UDDI (Universal Description Discovery and Integration) est un protocole basé sur XML qui sert à la publication et à l'exploration d'annuaires de Web Services. Il permet de situer un service Web, de le décrire, et de l intégrer. Ce protocole a été réalisé par IBM, Microsoft et Ariba. Cependant UDDI est assez complexe et a été qualifié par certains «d usine à gaz». C est la raison pour laquelle IBM et Microsoft travaille actuellement sur un autre protocole d annuaire de services : Web Services Inspection (WS-Inspection). L objectif de WS-Inspection est de permettre à une entreprise de décrire facilement les services Web dont elle dispose. SOAP Simple Access Protocol 4

5 5. Différence entre IIOP et SOAP IIOP (Internet Inter-ORB Protocol) est un protocole de transfert de méthode utilisé par CORBA. Il définit le format des messages échangés entre la machine cliente et la machine serveur. IIOP va permettre d envoyer et de recevoir des types complexes de données. Les clients et serveurs peuvent employer n importe quel mélange de langages et de plateformes. IIOP est un protocole très complet qui est capable d effectuer tous les transferts exigés par SOAP. Cependant l utilisation de SOAP peut être parfois préférable pour plusieurs raisons. Tout d abord, l utilisation de IIOP nécessite de compiler et distribuer des souches clients pour chaque type de clients avec qui l on communique. Ce n est évidemment pas très pratique, en particulier quand le nombre de plateformes différentes ou de langages différents est important. Dans le cas des services web, IIOP va poser des problèmes pour le franchissement des équipements de filtrage (firewall, proxy). Cela va demander un travail en plus de la part de chaque personne administrant l équipement. Au contraire, l utilisation de SOAP ne pose absolument pas de problèmes au niveau des firewalls. SOAP étant un protocole utilisant HTTP, il y a peu de chance qu il soit bloqué lors d un filtrage. Evidemment CORBA, au travers de IIOP, est plus performant : il y a moins de données transitant sur le réseau, et les opérations de conversion / déconversion sont traitées plus rapidement. Cependant avec SOAP les données circulent en format texte et en clair sur le réseau. Leur lecture en est donc facilitée et le déboguage est beaucoup plus simple. SOAP est donc un très bon protocole si l on cherche à dialoguer avec des plateformes hétérogènes, ce qui est particulièrement le cas dans toutes les applications de type «Web Services». En fait, l utilisation de CORBA ou de SOAP va surtout dépendre de ce que l on doit faire : dans le cas des webservices SOAP semble être une bonne solution, par contre si l on souhaite faire des applications distribuées classiques comme du calcul distribué, on choisira plutôt CORBA. 6. Protocoles utilisés par SOAP SOAP se sert le plus souvent de deux protocoles : HTTP et XML. Un message SOAP est écrit en XML. HTTP est utilisé comme protocole de transport. Les messages SOAP vont donc être encapsulés dans HTTP, ce qui permet une utilisation et une compatibilité très importante avec les réseaux et équipements existants. HTTP est le protocole de transport le plus utilisé mais il n est pas impossible de trouver des implémentations de SOAP sur d autres protocoles (avec SMTP par exemple). Un message SOAP est un document XML qui possède une enveloppe SOAP et éventuellement une déclaration XML. L enveloppe SOAP est composée d un corps SOAP et éventuellement d un en-tête. Les règles de syntaxe sont les suivantes : Un message SOAP MUST être codé en XML Un message SOAP MUST avoir une enveloppe SOAP Un message SOAP CAN avoir un entête SOAP (header) Un message SOAP MUST avoir un corps SOAP (body) SOAP Simple Access Protocol 5

6 Un message SOAP MUST utiliser l espace de désignation de l enveloppe SOAP Un message SOAP MUST utiliser l espace de désignation d encodage SOAP Un message SOAP MUST NOT contenir une référence à une DTD Un message SOAP MUST NOT contenir des instructions de type XML Processing Un message SOAP va être constitué d une enveloppe et d un corps. C est à l intérieur du corps (body) que l on trouve le contenu : //enveloppe du message <soap:envelope //espace de nommage pour l enveloppe SOAP xmlns:soap=" //on définit le type d encodage du message SOAP:encodingStyle=" //espace de nommage pour les types de variables xmlns:xsi=" xmlns:xsd=" //espace de nommage pour l appel de méthodes xmlns:tns=" //corps <soap:body> //espace de nommage pour la fonction getstatename <m:getstatename xmlns:m=" //on spécifie un argument à passer à getstatname <statenum xsi:type="xsd:int">41</statenum> </m:getstatename> //gestion d erreurs <soap:fault> </soap:fault> </soap:body> </soap:envelope> <envelope> est la racine ; <header>, <body>,et <fault> sont les enfants. SOAP Simple Access Protocol 6

7 Structure d un message SOAP Exemple: Message SOAP encapsulé dans une requête HTTP Voici une requête SOAP typique (avec les en-têtes HTTP) pour un appel à une méthode RPC nommée EchoString, qui prend une chaîne comme paramètre : POST /test/simple.asmx HTTP/1.1 Host: Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenc=" xmlns:tns=" xmlns:soap=" <soap:body soap:encodingstyle=" <tns:echostring> <inputstring>string</inputstring> </tns:echostring> </soap:body> </soap:envelope> Le nom de la méthode est appelé par la balise <tns:echostring> et le paramètre de type chaîne est défini par <inputstring>. La méthode qui est invoqué est donc de cette forme : SOAP Simple Access Protocol 7

8 public String echostring(string inputstring); Le serveur réponds alors: HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenc=" xmlns:tns=" xmlns:soap=" <soap:body soap:encodingstyle=" <tns:echostringresponse> <Return>string</Return> </tns:echostringresponse> </soap:body> </soap:envelope> Les règles de sérialisation du type de données de chaîne, ainsi que la forme de l'appel à une méthode, sont définies dans SOAP 1.1, sections 5 et 7 ( 7. Problèmes posés par SOAP : Ces problèmes concernent principalement l interopérabilité des messages SOAP de type RPC. La plupart des problèmes posés par SOAP ne concernent pas directement le protocole lui-même mais plutôt les protocoles utilisés, comme XML ou HTTP. Ils peuvent être divisés en trois catégories : - problèmes http - problèmes XML - problèmes liés au protocole SOAP a) Problèmes HTTP HTTP est utilisé pour le transport des messages SOAP en XML. Or certaines balises spécifiques à SOAP ne vont pas être bien interprétées par tous les clients HTTP. Cela va dépendre du client et ne pas fonctionner dans certains cas. On peut prendre l exemple de la fonction SOAPAction : la valeur de SOAPAction doit être en guillemets sauf s il s agit d une valeur nulle. Exemple : «SOAPAction: ou «SOAPAction:» Cependant certains clients ne sont pas capables de fournir une valeur d entête HTTP nulle, si le serveur en attends une, l appel ne fonctionnera pas. b) Problèmes XML Les problèmes d interopérabilité XML concernent l analyse du langage XML. SOAP repose sur l utilisation de ce langage, donc si XML pose des problèmes d implémentations, ceux-ci vont poser des problèmes sur SOAP. SOAP Simple Access Protocol 8

9 c) Problèmes liés à SOAP En lui-même, SOAP est relativement simple ; il requiert que les messages soient placés dans une enveloppe avec le texte du message inclus dans un élément du corps. Cependant il existe un certain nombre de problèmes d interopérabilité comme par exemple le problème lié à l implémentation de l attribut «mustunderstand». Les spécifications de SOAP indiquent que si cet attribut est défini sur la valeur «1», il devra être traité. Pourtant certaines implémentations de SOAP ne le font pas (principalement les premières à avoir été développées). De nombreux autres problèmes d interopérabilité ont été découverts, ils sont consultables sur le forum Cette liste contribue grandement à l amélioration du protocole. 8. Les fichiers WSDL Afin des décrire les services disponibles sur un serveur, un langage de description de service a été mis en place : le WSDL (Web Service Description Langage). Ce langage est basé sur XML. Les fichiers WSDL contiennent donc la description de l accès à des Web services ainsi que des messages qui seront échangés avec les services en question. (Arguments, types de donnée ). Une fois muni de cette description, appelée aussi parfois «contrat», le client va pouvoir dialoguer avec les services de manière adéquate. On peut par exemple générer automatiquement à partir du fichier WSDL un client ou un proxy pour ce service. Pour comprendre les différentes zones d un descripteur WSDL, le schéma suivant où se situent les différents éléments décrits dans un fichier WSDL. Différents éléments d un fichier WSDL (source : LearnXmlws, SOAP Simple Access Protocol 9

10 Un fichier WSDL commence par <definition> et finit par </definition>. C est à l intérieur de cette espace que l on va déclarer tous les éléments constituant la description. Nous allons prendre l exemple du Web Service de Google pour montrer comment se construit un fichier WSDL. Début de la description des services avec déclaration des différents schémas utilisés Nom unique identifiant cet ensemble de service au niveau du serveur <definitions name="urn:googlesearch" targetnamespace="urn:googlesearch" xmlns:typens="urn:googlesearch"... </definition> xmlns:xsd=" xmlns:soap=" xmlns:soapenc=" xmlns:wsdl=" xmlns=" a) Services Un service est la mise à disposition d une ou plusieurs méthodes. On peut imaginer par exemple une classe avec plusieurs méthodes invocables à distance. La classe sera le service, et chaque méthode sera une opération sur ce service. La définition d un service se fait par l utilisation de <service></service>. b) Port Pour chaque service on va définir des ports par lesquels ce service sera disponible. En effet, il est possible de rendre disponible un service sur plusieurs supports différents : HTTP GET, SOAP, SMTP Définition d un service Définition d un port avec l adresse du service (ici une URL) <service name="googlesearchservice"> <port name="googlesearchport" binding="typens:googlesearchbinding"> <soap:address location=" </port> </service> SOAP Simple Access Protocol 10

11 c) Message Les messages sont les éléments échangés entre le client et le serveur lors d une opération sur le port d un service. Ces messages sont constitués de plusieurs parties (part) qui représentent chacune une donnée avec un type associé. <message name="dogooglesearch"> <part name="key" <part name="q" <part name="start" <part name="maxresults" <part name="filter" <part name="restrict" <part name="safesearch" <part name="lr" <part name="ie" <part name="oe" </message> type="xsd:string"/> type="xsd:string"/> type="xsd:int"/> type="xsd:int"/> type="xsd:boolean"/> type="xsd:string"/> type="xsd:boolean"/> type="xsd:string"/> type="xsd:string"/> type="xsd:string"/> Définition d un message Chaque «part» du message a un nom et un type. Ici un type simple Utilisation d un type complexe <message name="dogooglesearchresponse"> <part name="return" type="typens:googlesearchresult"/> </message> Ainsi, il est possible définir ses propres types en se basant sur les types de base. En lisant cette définition dans le fichier WSDL, le client pourra générer éventuellement automatiquement une structure ou une classe reflétant cette description. Voici un exemple de type complexe qui représente le résultat d une recherche sur le Web service de Google : Définition d un type complexe Lien vers un autre type complexe <type> <xsd:complextype name="resultelement"> <xsd:all> <xsd:element name="summary" type="xsd:string"/> <xsd:element name="url" type="xsd:string"/> <xsd:element name="snippet" type="xsd:string"/> <xsd:element name="title" type="xsd:string"/> <xsd:element name="cachedsize" type="xsd:string"/> <xsd:element name="relatedinformationpresent" type="xsd:boolean"/> <xsd:element name="hostname" type="xsd:string"/> <xsd:element name="directorycategory" type="typens:directorycategory"/> <xsd:element name="directorytitle" type="xsd:string"/> </xsd:all> </xsd:complextype> </type> SOAP Simple Access Protocol 11

12 d) Port Type et Opérations Une méthode peut être représentée par une opération qui prend un message en entrée et renvoie un message en sortie. Ainsi chaque opération représentée par <operation></operation> indique les flux de messages en entrée et en sortie correspondants en définissant les élément <input/> et <output/>. Enfin, la collection de toutes les opérations d un service est rassemblée dans un port type. Définition d une opération (méthode) <porttype name="googlesearchport"> <operation name="dogetcachedpage"> <input message="typens:dogetcachedpage"/> <output message="typens:dogetcachedpageresponse"/> </operation> <operation name="dospellingsuggestion"> <input message="typens:dospellingsuggestion"/> <output message="typens:dospellingsuggestionresponse"/> </operation> On indique le nom des messages en entrée et en sortie <operation name="dogooglesearch"> <input message="typens:dogooglesearch"/> <output message="typens:dogooglesearchresponse"/> </operation> </porttype> SOAP Simple Access Protocol 12

13 e) Bindings Enfin, pour compléter la description, il faut relier certains éléments entre eux. C est le rôle des bindings représentés par les balises <binding></binding>. On va spécifier notamment tout ce qui concerne l encodage des données dans les messages en indiquant les règles que l on utilise. Définition de la couche transport utilisée Pour chaque opération, on défini les règles d encodage des données <binding name="googlesearchbinding" type="typens:googlesearchport"> <soap:binding style="rpc" transport=" <operation name="dogooglesearch"> <soap:operation soapaction="urn:googlesearchaction"/> <input> <soap:body use="encoded" namespace="urn:googlesearch" encodingstyle=" </input> <output> <soap:body use="encoded" namespace="urn:googlesearch" encodingstyle=" </output> </operation> </binding> SOAP Simple Access Protocol 13

14 Deuxième Partie : Installation et mise en œuvre Un des avantages de SOAP est sa capacité à faire communiquer des plateformes hétérogènes. C est pourquoi plusieurs implémentations de SOAP on été développées (ou sont encore en développement). Nous en avons testé quelques unes, utilisant chacune un langage différent : Apache SOAP pour une implémentation Java, NuPHP pour le PHP, et SOAP::Lite pour le langage Perl. Pour chacune, nous allons présenter brièvement les procédures d installation, et quelques exemples de mise en œuvre. 1. Apache SOAP La distribution Apache SOAP ( fournit les librairies nécessaires pour invoquer des services SOAP distants, et des outils côté serveur pour implémenter des services SOAP. En tant que librairie cliente, il offre une API pour invoquer des services SOAP RPC et une API pour envoyer et recevoir des messages SOAP. Pour mettre en œuvre un service accessible par RPC ou par messages, Apache SOAP doit être hébergé par un conteneur de servlets comme Apache Tomcat. Le transport principal est le http, même si le support d autres protocoles peut être ajouté (SMTP par exemple). a) Installation Prérequis côté serveur : jdk (1.2 ou ulterieur), un conteneur de servlets (tomcat par exemple), un parseur XML (xerces par exemple), les classes soap (le fichier soap.war inclus dans la distribution de soap suffit pour tomcat), classes annexes dans certains cas. Prérequis côté client : classes soap, mail.jar, activation.jar, classpath correct pour compiler le code java. Tomcat est un conteneur de servlets JSP qui intègre son propre serveur web. Il ne necessite donc pas l installation d un serveur web séparé. L installation de tomcat ne pose pas de problème particulier. Il suffit d extraire l archive fournie et de démarrer le serveur pour vérifier que les exemples de servlets fonctionnent. Le serveur se lance par défaut sur le port 8080, qui peut être modifié dans les fichiers de configuration de tomcat. L installation de soap sous tomcat se fait simplement en copiant l archive web soap.war dans le repertoire d applications web de tomcat (jakarta-tomcat-4.0.3/webapps). On peut également créer un nouveau <Context> pour le serveur tomcat, qui indiquera où trouver les classes SOAP. Cela implique d ajouter les chemins d accès vers tous les services à deployer dans le classpath. Dans les deux cas, il faut systématiquement redémarrer le serveur pour prendre en compte les modifications. Nous avons choisi de mettre en œuvre Apache SOAP de la première façon, qui utilise la configuration par défaut du serveur tomcat. Lancement et arret du serveur : /mci/projet/proj01/soap/jakarta-tomcat-4.0.3/bin/startup.sh /mci/projet/proj01/soap/jakarta-tomcat-4.0.3/bin/shutdown.sh SOAP Simple Access Protocol 14

15 Pour tester le bon fonctionnement du serveur, il suffit d ouvrir les pages suivantes : Le serveur doit répondre «SOAP (RPC Message) Router Sorry, I don't speak via HTTP GET- you have to use HTTP POST to talk to me.» Si le client est correctement configuré, la commande suivante affichera la liste des services déployés sur le serveur : java org.apache.soap.server.servicemanagerclient list b) Exemple d utilisation Notre exemple conmprend 3 fichiers : - EchoService.java Le code du serveur d echo - GetEcho.java le code du client chargé d appeler le service d echo - DeploymentDescriptor.xml contient la description du service. Ce fichier facilite le déploiement d un service sur le serveur. Compiler les sources java (javac *.java) apres avoir verifie le classpath. Placer les classes dans "/mci/projet/proj01/soap/jakarta-tomcat /webapps/soap/WEB-INF/classes/samples/echo"! serveur : EchoService.java package samples.echo; public class EchoService public String getecho(string s) return "*echo* " + s; Renvoi de la chaine reçue SOAP Simple Access Protocol 15

16 ! client : GetEcho.java package samples.echo; import java.net.*; import java.util.*; import org.apache.soap.*; import org.apache.soap.rpc.*; Importation des classes nécessaires public class GetEcho public static void main (String[] args) throws Exception if (args.length!= 2 && (args.length!= 3!args[0].startsWith ("-"))) System.err.println ("Usage: java " + GetEcho.class.getName () + " [-encodingstyleuri] SOAP-router-URL chaine"); System.exit (1); // Traitement des arguments. int offset = 3 - args.length; String encodingstyleuri = args.length == 3? args[0].substring(1) : Constants.NS_URI_SOAP_ENC; URL url = new URL (args[1 - offset]); String chaine = args[2 - offset]; Traitement des arguments // Construction de l appel. Call call = new Call (); Construction de l appel call.settargetobjecturi ("urn:test-myecho"); call.setmethodname ("getecho"); call.setencodingstyleuri(encodingstyleuri); Vector params = new Vector (); params.addelement (new Parameter("chaine", String.class, chaine, null)); call.setparams (params); // appel: l URI action est vide (non utilisée par XML-SOAP) Response resp = call.invoke (/* router URL */ url, /* actionuri */ "" ); // Check the response. if (resp.generatedfault ()) Fault fault = resp.getfault (); System.err.println("Generated fault: " + fault); else Parameter result = resp.getreturnvalue (); System.out.println (result.getvalue ()); Affichage du résultat Appel Verification de la réponse SOAP Simple Access Protocol 16

17 ! DeploymentDescriptor.xml <isd:service xmlns:isd=" id="urn:test-myecho"> <isd:provider type="java" scope="application" methods="getecho"> <isd:java class="samples.echo.echoservice"/> </isd:provider> <isd:faultlistener>org.apache.soap.server.domfaultlistener</isd:faultlistener> </isd:service>! Utilisation : Les services peuvent être déployés à l aide de l interface web de la distibution Apache SOAP ( ou plus simplement en utilisant la classe ServiceManagerClient fournie : java org.apache.soap.server.servicemanagerclient deploy DeploymentDescriptor.xml java org.apache.soap.server.servicemanagerclient undeploy urn:test-myecho java org.apache.soap.server.servicemanagerclient list Le client prend en paramètres l adresse du routeur RPC et le texte à envoyer : java samples.echo.getecho montexte Apache SOAP n offre pas de support du wsdl côté client. Un utilitaire séparé fourni par IBM permet toutefois de créer un code client à partir d un fichier wsdl, mais son utilisation n est pas pratique. SOAP Simple Access Protocol 17

18 2. NuSoap NuSOAP est une implémentation en PHP de SOAP disponible gratuitement sur Internet (licence LGPL) : Il a été développé par Dietrich Ayala pour Nusphere (IDE pour PHP : Ce kit est constitué de plusieurs classes permettant la mise en place de clients et de serveurs SOAP en utilisant le langage PHP. Ce langage est très utilisé pour construire des sites Web dynamiques, l accès aux Web Services est donc la bienvenue. a) Installation Cette implémentation de SOAP est assez simple à installer et à utiliser puisqu aucun serveur spécifique (autre qu un simple serveur Web) n est requis. Il suffit de mettre sur le serveur un simple script PHP pour avoir acces à des services. La partie serveur est démarrée à chaque appel de l URL du script implémentant la partie serveur pour SOAP. C est entre autre cela qui fait la simplicité de mise en place de cette implémentation : il suffit de faire un «include» du fichier contenant les classe de NuSOAP pour pouvoir déployer ou invoquer des services. b) Exemples d utilisation! Script serveur : déploiement du service myecho <?php require_once('../nusoap/nusoap.php'); $s = new soap_server; $s->register('myecho',false,false,"urn:myecho"); function myecho($chaine) // optionally catch an error and return a fault if($chaine == '') return new soap_fault('client','','la chaine est vide.'); $res="vous avez envoyé:".$chaine; return $res; $s->service($http_raw_post_data);?> Inclusion des classes NuSoap Création d un objet «serveur» Enregistrement du service myecho auprès du serveur Fonction effectuant le service (Fonction qui sera appelée par RPC) Envoie des réponses du serveur au client : Ici, NuSoap va générer le message réponse du serveur en XML et l envoyer dans la réponse http au client. SOAP Simple Access Protocol 18

19 ! Script Client : appel direct au service myecho (sans utiliser le fichier WSDL) Appel aux classes de NuSOAP Préparation du tableau contenants les paramètres à passer au service $lachaine : variable contenant la chaine à passer lors de l appel Création de l objet client avec l URL du service SOAP à appeler. Ici c est l URL du script serveur écrit en PHP <?php require_once('../nusoap/nusoap.php'); if($lachaine!=null) $parameters = array('chaine1'=>$lachaine); $soapclient = new soapclient(' echo $soapclient->call('myecho',$parameters); else echo "<- Remplir le formulaire";?> Appel de la méthode distante myecho avec passage du tableau des paramètres! Script Client : appel direct service myecho avec le fichier WSDL et le proxy NuSOAP permet, si l on utilise les descripteurs de services écrits en WSDL, de générer un proxy pour service. Ce proxy permet d accéder à la méthode distante comme si elle était une méthode d un objet local. Cela permet d avoir un code beaucoup plus clair et moins lourd. SOAP Simple Access Protocol 19

20 Exemple d utilisation : <?php require_once('../nusoap/nusoap.php'); $soapclient= new soapclient(' ); $proxy=$soapclient->getproxy(); $res=$proxy->myecho($lachaine); echo $res; Appel à la procédure distante via le proxy Création du proxy Création du client à partir d un fichier WSDL 3. SOAP::Lite SOAP::Lite ( est un ensemble de modules Perl qui fournissent une interface simple et légère vers SOAP, côté client et côté serveur. Il est préférable d installer la distribution en tant que root bien qu il soit possible d installer les modules dans son propre repertoire de travail. a) Installation De nombreux modules sont nécessaires à SOAP::Lite MIME-Base IO-1.20 URI-1.19 MIME-Lite HTML-Parser-3.26 HTML-Tagset-3.03 libnet-1.12 MIME-tools IO-stringy MailTools-1.46 XML-Parser-2.31 libwww-perl-5.65 Les commandes pour installer les modules dans ~/perl (pour un utilisateur normal) sont : perl Makefile.PL LIB=~/perl make make test make install SOAP Simple Access Protocol 20