Compte-rendu TP Systèmes répartis JAX-WS
Compte-rendu TP Systèmes répartis JAX-WS
Programming, Web Services, JAX-WS, SOAP · lab
Fiche de révisionGuide de TP
Rédigée à partir de ce document, puis vérifiée avant publication.
Ce TP permet de découvrir la création et le déploiement de services web distribués utilisant le protocole SOAP via la technologie JAX-WS. Il guide l’étudiant dans l’écriture d’un service simple HelloWorld, puis dans la réalisation d’un service calculatrice plus avancé, avec des échanges d’objets Java sérialisés grâce à JAXB. Pour suivre ce TP, il faut disposer d’un environnement Java (JDK 8) sous Linux Ubuntu 14.04, d’un éditeur de texte et de l’outil SoapUI pour tester les services.
Cette étape consiste à créer un service web simple qui expose une méthode sayHello. Elle permet de comprendre la structure d’un service JAX-WS et la génération automatique du fichier WSDL.
com.dhia.ws avec le fichier HelloWorld.java.HelloWorldImpl.java situé dans le même package.com.dhia.endpoint. Cette classe lie l’adresse du service à la classe d’implémentation HelloWorldImpl.Compilation et lancement du service :
$ javac com/dhia/ws/*.java
$ javac com/dhia/endpoint/*.java
$ java com.dhia.endpoint.HelloWorldPublisher
Une fois lancé, le service génère automatiquement un fichier WSDL décrivant son interface.
Pour tester le service, deux options sont possibles :
Avec SoapUI, il faut créer un nouveau projet SOAP en fournissant l’URL du fichier WSDL généré par le service. SoapUI crée alors la structure du projet et permet d’envoyer des requêtes XML à la méthode sayHello du service.
Une requête XML typique et la réponse du service doivent s’afficher dans SoapUI, confirmant que le service fonctionne correctement.
Cette étape montre comment créer un service web plus complexe qui échange des objets Java via JAXB. Le service calculatrice reçoit un objet, effectue un calcul, puis renvoie un résultat.
RObject, avec ses propriétés, accesseurs (getters/setters) et annotations JAXB nécessaires.RObjectService qui déclare les méthodes exposées par le service calculatrice.Une fois le service lancé, SoapUI est utilisé pour envoyer des requêtes contenant des objets RObject sérialisés en XML. Le service traite ces objets et renvoie les résultats correspondants, également sous forme XML.
sayHello avec un message de salutation correct.RObject, effectuer le calcul demandé, et renvoyer un résultat conforme.