TP: Clients

Modalités

Groupes

Ce TP est à effectuer en binômes à constituer au sein du groupe TI5. Cette semaine encore il est possible pour les étudiants qui n'ont pas suivi le M1 au département l'an dernier de former un trinôme avec des deux autres étudiants.

Rendu

Ce TP est à rendre pour le 29/09/2014, à raison d'un rendu par binôme. Le rendu se fera par l'intermédiaire d'un projet forge (on fera attention a bien donner au moin le rôle “reporter” à Emmanuel Coquery et à Lionel Medini) contenant:

  • le fichier xml du projet soapUI
  • le projet maven de l'interface en ligne de commande (sans le répertoire target)
  • un fichier README.txt contenant au moins les noms, prénoms et numéros d'étudiants du binôme/trinôme. Toute autre information à transmettre aux enseignants (e.g. justifications de choix techniques) se fera dans ce fichier.

L'identifiant du projet forge (de la forme pxxxxxx-nomprojet) est à saisir dans Tomuss, dans l'UE Tiw5 WebServices, dans la case TP2_F. On fera attention à tagger la révision correspondant au rendu avec le tag TP2

<note important>Si la case de rendu n'est pas disponible dans tomuss pour TIW5, une case sera ajoutée dans l'étape comme pour le TP1</note>

Introduction

L'objectif de ce TP est d'utiliser et de créer des clients pour un service web. Pour cela, on s'appuiera sur un service de récupération et de mise à jour. Le service est fourni sous la forme d'un war à déployer sur tomcat: soir la section Déploiement. La servlet CXF est disponible à l'URL suivante après déploiement: http://localhost:8080/cineservice/services, ou (selon le mode de déploiement) http://localhost:8080/services.

La première partie du TP requiert l'utilisation de soapUI. Mirroir local pour la version Windows, à décompresser sur le disque local en salle de TP.

soapUI

soapUI est un logiciel de test pour les services Web. Lancer soapUI et créer un nouveau projet. Le logiciel propose de charger un fichier WSDL et de générer des squelettes de tests. Utiliser le wsdl du service fourni et déployé précédemment. Modifier la requête pour l'opération seances (avec des données) et l'exécuter. Faire de même avec la requête pour l'opération reserver.

Créer ensuite un test avec ces deux requêtes. On vérifiera dans ce test qu'un client ne peut pas réserver plus de places que la capacité de la salle.

Client en ligne de commande

Creer un nouveau projet maven via Eclipse ou la commande

mvn archetype:generate

On choisira la réponse proposée par défaut pour le type de projet1) et la version. Le choix du groupId2), de l'artifactId3) et des autres paramètres est laissé libre. Importer ensuite le projet dans Eclipse/Netbeans/IntelliJ.

Dans ce projet, on créera un client pour le service précédent. On utilisera l'API SAAJ pour envoyer et recevoir des messages du service. Le client sera constitué d'une interface texte avec un menu permettant de choisir entre l'affichage (en mode texte) des seances pour un jour donné par l'utilisateur et la réservation de places (les données étant saisies via l'interface texte).

Bonus

Reprendre les fonctionnalités du client en ligne de commande avec un client AJAX. Pour éviter les problèmes avec CORS, déployer sous forme d'un projet web jee dans le même serveur tomcat.

Déploiement

Le fichier war peut être créé en utilisant la commande mvn package depuis le répertoire cineservice (après avoir mis à jour le dépôt depuis la forge ou archive inf2018m-2014-base.zip qui a été mise à jour).

Pour le déployer dans tomcat:

  • Si vous lancez le tomcat depuis l'IDE, ajouter le war dans la configuration de lancement
  • Si vous lancez le tomcat depuis le shell, copier le war dans le répertoire de déploiement4)
  • Il est aussi possible de lancer le service directement depuis le répertoire cineservice via mvn tomcat7:run
1)
maven-archetype-quickstart
2)
équivalent au package, e.g. sw.films
3)
e.g. client
4)
par défaut webapps