A. Roussanaly - Université Nancy2 AXIS Master MIAGE/SID – Université NANCY2

A. Roussanaly - Université Nancy2 Généralités Open source de Apache Software Foundation Moteur SOAP Compatible JAX-RPC Distribué avec des outils de développement et de monitoring Accompagné de documentation et d'exemples

A. Roussanaly - Université Nancy2 Architecture JAX-RPC HTTP SOAP JAX-RPC API ClientAPI Serveur WSDL CLIENTSERVICE

A. Roussanaly - Université Nancy2 Architecture Axis JVM Moteur de Servlet AxisServlet La Servlet AxisServlet reçoit et renvoie les messages SOAP et transmet aux objets Java correspondant Les Objets Java effectuent les services. Ils sont des objets Java classiques. Objets Java et Servlet sont dans la même JVM (pas de répartition). SOAP/HTTP Le client envoie des messages SOAP/HTTP D'après Xavier Blanc

A. Roussanaly - Université Nancy2 Axis2 JVM Moteur de Servlet AxisServlet Archives au format.aar SOAP/HTTP

A. Roussanaly - Université Nancy2 Activité : développer un serveur Développer un serveur qui fournit le change de différentes monnaies par rapport au DM Ecrire ensuite une application de conversion de monnaies (client) Exemple dopérations: getDollar() getFrancSuisse() getLivre() getYen()

A. Roussanaly - Université Nancy2 ARCHIVES

A. Roussanaly - Université Nancy2 Créer un service web avec Axis2… …et Eclipse for J2EE developper

A. Roussanaly - Université Nancy2 Configuration

A. Roussanaly - Université Nancy2 Créer un projet

A. Roussanaly - Université Nancy2 Ajouter automatiquement les jar de Axis2 dans lib

A. Roussanaly - Université Nancy2

Créer une classe

A. Roussanaly - Université Nancy2 Générer le WS

A. Roussanaly - Université Nancy2

Tester le service

A. Roussanaly - Université Nancy2 Axis Ecriture dun serveur

A. Roussanaly - Université Nancy2 Projet Eclipse/Tomcat build.xml project.properties deploy.wsdd undeploy.wsdd index.jsp… axis-change src classeslib fr.miage.sid.axis.server axis.jar axis-ant.jar wsdl4j.jar mail.jar activation.jar….java.class WEB-INF web.xml server-config.wsdd perms.lst users.lst…

A. Roussanaly - Université Nancy2 Properties name=poub version=1.0 year=2006 debug=on deploy.file=deploy.wsdd undeploy.file=undeploy.wsdd service.host=localhost service.port=80 service.package=fr.miage.sid.axis.server

A. Roussanaly - Université Nancy2 Service « rapide » Dans un premier temps, il nous faut un service ; Axis permet den créer de manière très rapide. Pour notre application, nous allons créer un service qui nous permet dobtenir le cours de différentes monnaies en euro. Exemple dopérations: getDollar() getFrancSuisse() getLivre() getYen()

A. Roussanaly - Université Nancy2 Change : service Créer un programme source java exemple : une classe Change qui fournit le taux de change de lUSD, CHF, JPY, GBP Modifier l'extension.java du fichier source en.jws Déployer le fichier.jws copie dans %tomcat%\webapps\axis

A. Roussanaly - Université Nancy2 Listing : Change.jws public class Change { private double EU_USD = 1.251; private double EU_CHF = 1.592; private double EU_JPY = ; private double EU_GBP = 0.670; public double getDollar(){return EU_USD;} public double getFrancSuisse(){return EU_CHF;} public double getYen(){return EU_JPY;} public double getLivre(){return EU_GBP;} }

A. Roussanaly - Université Nancy2 Test du service Change Examiner sa description WSDL Enregistrer le fichier WSDL dans un projet Eclipse Exemple : change.wsdl Tester ce service avec les outils Eclipse/WTP Menu contextuel Web Services sur change.wsdl et Test with Web services Explorer…

A. Roussanaly - Université Nancy2 Change : client On peut maintenant écrire une application cliente du service change. Par exemple, un convertisseur de monnaie :

A. Roussanaly - Université Nancy2 Ecriture « normale » dun service Usage des fichiers JWS limité : Obligation de travailler avec le code source Pas de possibilité de mappings Pas de possibilité de contrôle avec un handler On est donc amené à déployer des classes (ou éventuellement des jars)

A. Roussanaly - Université Nancy2 Ecriture « normale » dun service Le point de départ peut être : 1.un fichier WSDL : On utilise alors loutil WSDL2JAVA pour engendrer le « squelette » dun serveur (skeleton) 2.une classe JAVA : Le fichier WSDL est dynamiquement engendré par le servlet Axis

A. Roussanaly - Université Nancy2 Etapes 1.Développer le service et lintégrer dans un projet Tomcat contenant le servlet Axis (autrement dit déployer le servlet Axis sous Tomcat) 2.A laide dun fichier de descripteur de déploiement (WSDD) propre à Axis, déployer le service Axis Il sagit de mettre à jour le fichier de configuration server-config.wsdd qui se trouve dans le dossier WEB-INF dAxis On utilise loutil AdminClient dAxis

A. Roussanaly - Université Nancy2 Ant

A. Roussanaly - Université Nancy2 WSDD <deployment xmlns=" xmlns:java="

A. Roussanaly - Université Nancy2 Explications Loutil AdminClient sappuie (1) sur les informations contenues dans le fichier WSDD et (2) sur les arguments passés en paramètres (host, port, axis-root) axis.jar et axis-ant.jar doivent être dans le classpath. Axis crée un servive appelé : / /services/ Le WSDL du service is accessible à : / /services/ ?wsdl Une liste des services est visible à : / /services

A. Roussanaly - Université Nancy2 WSDD avancée Scope...> />... : "Request" "Session" "Application"

A. Roussanaly - Université Nancy2 Annexes (archives)

A. Roussanaly - Université Nancy2 Exemple client n°1 (DII) public String endPoint = " public String operationName = "addInt"; public int invokeService(int a, int b) throws Exception{ Service service = new Service(); Call call = (Call) service.createCall(); call.setOperationName(new QName(endPoint, operationName)); call.setTargetEndpointAddress( new URL(endPoint) ); Integer ret = (Integer) call.invoke( new Object[] { new Integer(a), new Integer(b)} ); return ret.intValue(); }

A. Roussanaly - Université Nancy2 Exemple client n°2 (PROXY) public String wsdlUrl = " public String nameSpaceUri = " public String serviceName = "AddFunctionService"; public String portName = "AddFunction"; public int invokeService(int a, int b) throws Exception{ ServiceFactory serviceFactory = ServiceFactory.newInstance(); Service afService = serviceFactory.createService( new URL(wsdlUrl), new QName(nameSpaceUri, serviceName)); AddFunctionServiceIntf afsIntf =(AddFunctionServiceIntf)afService.getPort(new QName(nameSpaceUri, portName), AddFunctionServiceIntf.class); return afsIntf.addInt(a, b); }

A. Roussanaly - Université Nancy2 Exemple client n°2 (PROXY) public interface AddFunctionServiceIntf extends java.rmi.Remote { public int addInt(int a, int b) throws java.rmi.RemoteException; }

A. Roussanaly - Université Nancy2 Exemple client n°3 (STUB) public int invokeService(int a, int b) throws Exception{ AddFunctionService afs = new AddFunctionServiceLocator(); AddFunction af = afs.getAddFunction(); return af.addInt(a, b); } Générer préalablement le stub à l'aide de l'outil WSDL2Java

A. Roussanaly - Université Nancy2 Déploiement de service %java org.apache.axis.client.AdminClient MyService.wsdd

A. Roussanaly - Université Nancy2 Axis Ecriture dun client

A. Roussanaly - Université Nancy2 Ecriture d'un client On a le choix entre 3 méthodes : Proxy Cas dutilisation : type des paramètres et résultat connus (voir exemple annexe de présentation) Interface d'invocation dynamique (DII) : Cas dutilisation : on ne connaît que lurl du service => invocation dynamique des méthodes (voir exemple annexe de présentation) Génération d'un Stub à partir d'une description WSDL Cas dutilisation : connaissance préalable du WSDL On se place dans ce cas dans la suite…

A. Roussanaly - Université Nancy2 Synopsis de lapplication Change.wsdl WSDL2JAVA ChangeSoapBindindStub.java UI.java Convertisseur.java JAVAC ChangeServiceLocator ChangeService.java Change.java

A. Roussanaly - Université Nancy2 Projet Eclipse build.xml project.properties ChangeAxisClient src binlib fr.miage.sid.axis.clientimg stub axis.jar axis-ant.jar wsdl4j.jar mail.jar activation.jar….java.java (wsdl2java).class.jpg

A. Roussanaly - Université Nancy2 Ant …

A. Roussanaly - Université Nancy2 Ant <taskdef name="wsdl2java" classname="org.apache.axis.tools.ant.wsdl.Wsdl2javaAntTask">

A. Roussanaly - Université Nancy2 Ant <!-- ==================================================================== Créer un stub avec wsdl2java ==================================================================== --> <target name="wsdl2java" description="Génération d'un stub (client)">