Feuille de TP services web

Université Cergy-Pontoise
Formation SAGEM
Services web
Travaux pratiques
1. Création de service web
Nous utiliserons l’API JAX-WS avec un serveur d’applications Java, déjà installés sur votre
machine. Le principe est d’écrire un service comme une classe Java dont une partie des
méthodes sont les opérations du service. Exemple simple : le programme Calcul.java sur la
page du cours http://depinfo.u-cergy.fr/~vodislav/SAGEM/.
Etapes :
1. Lancez le serveur d’applications Java Application Server sur votre machine avec la
commande :
asadmin start-domain domain1
2. Téléchargez sur votre machine l’archive du tutoriel JAX-WS, disponible sur le site du
cours. Il contient tous les fichiers de configuration nécessaires pour construire un
service web. Extrayez les fichiers de cette archive dans votre répertoire d’accueil, ce
qui créera un répertoire jwstutorial20.
3. Dans le sous-répertoire examples/common du tutoriel, modifiez le fichier
build.properties en renseignant les valeurs des propriétés javaee.home=/persist/j2ee/ et
javaee.tutorial.home=le chemin complet vers votre tutoriel (par exemple
/home/etud01/ jwstutorial20/)
4. Dans le sous-répertoire examples/jaxws, faites une copie du répertoire helloservice
vers un répertoire appelé calculservice, qui servira à la création du service Calcul.
5. Dans le sous-répertoire src de calculservice, remplacez le fichier Hello.java par
Calcul.java, récupéré depuis le site du cours.
6. Dans le fichier build.properties de calculservice, remplacez dans les valeurs des
propriétés « hello » par « calcul » (example=calculservice, war-file=calcul-jaxws.war,
…). Faites la même chose dans les trois fichiers XML de configuration, présents dans
le sous-répertoire etc de calculservice.
7. Dans la fenêtre de commande, placez vous dans calculservice et lancez la commande :
asant build
qui crée les fichiers du service web dans un sous-répertoire build, ensuite :
asant create-war
qui crée l’archive web du service (fichier .war) dans un sous-répertoire assemble.
8. Pour déployer le service Calcul, copiez le fichier calcul-jaxws.war du sous-répertoire
assemble/war vers le répertoire /persist/j2ee/domains/domain1/autodeploy.
9. Si le service est bien déployé, sa description WSDL est visible à l’adresse
http://localhost:8080/calculservice/CalculService?WSDL. Identifiez dans cette
description la structure des messages d’appel et de retour, ainsi que l’adresse (URL)
d’appel du service.

10. Testez le fonctionnement du service à l’aide de la page de test fournie par le serveur à
l’adresse http://localhost:8080/calculservice/CalculService?Tester. Observez bien la
structure des messages SOAP d’appel et de réponse.
2. Appel de service web
A. Utilisation de SOAP en Java
L’appel de service est réalisé à travers un message SOAP d’appel envoyé au service, suivi de
l’interprétation du message SOAP de réponse.
Créer un projet Java dans Eclipse et créer un package testclient dans ce projet. Copier dans ce
package le squelette de programme AppelSoap.java disponible sur la page du cours.
Remplacer dans ce squelette les parties en majuscules par les valeurs correspondantes
identifiées dans la description WSDL du service Calcul.
Exécuter ce programme et vérifier le résultat obtenu.
B. Utilisation de JAX-WS
L’appel est beaucoup plus simple, il se réduit à un appel de méthode sur un objet de la classe
qui réalise le service. Si le service a lui-même été créé avec JAX-WS (donc avec un objet
Java), alors l’appel du service revient à l’appel des méthodes de cet objet. Avantage : on reste
dans le modèle objet Java avec appels de méthodes sur des objets, la couche SOAP et la
manipulation des messages XML sont totalement cachées.
Il faut tout d’abord générer les classes proxy pour le service avec la commande :
wsimport -keep -verbose -d REPERTOIRE_CLASSES -s REPERTOIRE_SOURCES
-p NOM_PACKAGE ADRESSE_WSDL
Pour l’appel au service Calcul, utiliser pour les paramètres –d et –s le répertoire des sources
du projet Java Eclipse et pour –p le nom de package clientcalcul.
Copier dans le package testclient de votre projet Eclipse le squelette de programme
AppelJaxws.java disponible sur la page du cours. Remplacer dans ce squelette les parties en
majuscules par les valeurs correspondantes (le nom de la classe est ici Calcul).
Exécuter ce programme et vérifier le résultat obtenu.