Déploiement d'un web service

Objectif du document

Fournir un guide pour le déploiement d’un Web-Service une fois que la fonction est réalisée.

Prérequis
· Eclipse 2.2 ou 2.3 (Version testée)
· Axis 1.3 (Version testée)
Comment déployer sa fonction en tant que Web-Service
Une fois le service développé, nous créons une librairie, mondispositifservice.jar. Il s’agit maintenant de la déployer sous forme de Web-service.

1. Nous créons un projet Web Dynamique à l’aide de eclipse : Fichier --> New …



2. On se laisse guider par l’assistant. Il faut veiller à ne pas selectionner les modules AXIS2 qui sont proposés à la fin de l’assistant (Nous n’utilisons pas AXIS2)

3. Dans le repertoire WebContent/WEB-INF/lib du projet généré, nous copions les librairies

· aida-meta.jar
· aida-commons.jar
· mondispositifservice.jar

4. Le Web-Service est déployé par la commande New--> Web-Service
Un assistant nous est proposé.

Choisir
· L’implémentation du service la classe qui réalise notre fonction dans service implementation


· Le project qui hébergera notre application (le service project )


Dans l’écran suivant vérifier que l’affichage correspond aux méthodes que l’on souhaite rendre accessible par Web Service.





Dans l’écran suivant. Il n’est pas nécessaire d’inscrire son WEB-Service sur un UDDI.



5. Enfin, pour terminer il faut affecter les bons namespaces. Un fichier généré : server-config.wsdd a été généré. Les namespaces doivent être affecté à : http://www.agriculture.gouv.fr/AIDA/2007. http://utils.commons.aida doit être remplacé par http://www.agriculture.gouv.fr/AIDA/2007
6. Au redémarrage du serveur. Le service devrait fonctionner, il faut pour le vérifier verifier que son WSDL utilise le bon namespace (http://www.agriculture.gouv.fr/AIDA/2007) et effectuer un test à l’aide d’un client.
Comment tester son implémentation
Un client correspond à la génération d’un certain nombre de fichier JAVA. Ces fichiers seront par la suite compilés et permettrons de se connecter au web service. Le processus le naturel pour générer un lient Web service est le suivant :

1- Télécharger le descripteur de déploiement
2- Générer le client à l'aide d'un assistant
3- Tester le service
1- Télécharger le descripteur de déploiement
Si le serveur est un serveur axis, http://monserveur.com/axis-webapp/services donne accès à des liens vers les descripteur de déploiement. Sur le lien WSDL télécharger le descripteur de déploiement. (Lien en bleu)

And now... Some Services
· AdminService (wsdl)
o AdminService
· Version (wsdl)
o getVersion
· AidaService (wsdl)
o rechercherListeDossiers
o detailDossier

2- Générer le client de Web service à l'aide d'un assistant
En utilisant Eclipse, la génération d'un client est très simple. Se placer dans un projet java, on générera le client dans un projet, par exemple, ws-test
Dans le menu Fichier --> Nouveau, choisir client de Web Service, l'écran suivant apparait




Dans le second écran on renseigne l'url ou se trouve le WSDL



Les options par défaut, génère seulement le client.
3- Tester le service

Pour se servir du service, on utilise Locator pour résoudre la localisation du service au niveau du réseau, des namespaces, puis on se sert du service comme s'il s'agissait d'une fonction tout à fait ordinaire.

MyServiceLocator locator = new MyServiceLocator();
MyService service = locator.getMyService();
String result = service.fonction01("param1","param2");