java

AXIS

Apache AXIS

http://ws.apache.org/axis2

Un moteur qui implémente de protocole SOAP :
- sur transport HTTP
- qui fonctionne seul
- en pluggin de TOMCAT
- implémente WSDL
- des outils WSDL2Java et Java2WSDL
- ....

Téléchargez le serveur TOMCAT d'APACHE :

http://tomcat.apache.org/ download ... binary distrib ... core .... zip
intallez Tomcat 5.5.34
- dézippez-le

Ajoutez des variables d'environnement :
JAVA_HOME CATALINA_HOME chemin vers le répertoire d'installation de TOMCAT

Voici un fichier ad-hoc setenv.sh

JAVA_HOME=/usr/lib/jvm/java-6-sun; export JAVA_HOME
CATALINA_HOME=$HOME/chemin_a_preciser/apache-tomcat-5.5.34 ; export CATALINA_HOME
PATH=.:$PATH ; export PATH

le rendre exécutable : chmod u+x setenv.sh
A exécuter ainsi à chaque fois que vous ouvrez une console terminal ! ... ne fermez pas votre console !
. setenv.shLe point indique d'exécuter dans le shell même et non dans un shell processus fils

pour vérifier l'état de vos variables d'environnement : la commande env
rendez exécutable les .sh du répertoire bin :
chmod u+x $CATALINA_HOME/bin/*.sh

Démarrez TOMCAT :
$CATALINA_HOME/bin/startup.sh
testez TOMCAT :
Dans un Navigateur, essayez http://localhost:8080/
puis vérifiez que les JSPs proposés fonctionnent

Installez et pluggez AXIS2 à TOMCAT :
- http://axis.apache.org/axis2/java/core/
- Télécharger axis2 1.5 le war :
  download ... realease ... 1.5.6 ..... WAR Distribution
- dézippez axis2-1.5.6-war.zip
- copiez le dossier axis2.war dans $CATALINA_HOME/webapps : cp axis2.war $CATALINA_HOME/webapps
- redémarrez Tomcat :
  $CATALINA_HOME/bin/shutdown.sh$CATALINA_HOME/bin/startup.sh
- Testez AXIS :
  - Dans un Navigateur, essayez http://localhost:8080/axis2
  - puis vérifiez que les services proposés fonctionnent
    - validate
Installez le client AXIS2 :

Télécharger axis2 1.5 le zip
download ... realease ... 1.5.6 ..... Binary Distribution zip
dézippez axis2-1.5.6-bin.zip
Préparez les variables pour les clients :

Ajoutez une variable d'environnement : AXIS2_HOME
Modifiez le CLASSPATH pour prendre en compte les jars d'AXIS et le PATH pour ses utilitaires :
dans le fichier setenv.sh, ajoutez les lignes :
AXIS2_HOME=$HOME/chemin_a_preciser/axis2-1.5.6 export AXIS2_HOME
PATH=$PATH:$AXIS2_HOME/bin ; export PATH
CLASSPATH=$CLASSPATH:$AXIS2_HOME/lib/* ; export CLASSPATH
re-exécutez : . setenv.sh

Un premier web service

Le service :
Source de TwiceSoapService.java

package service.twice;
public class TwiceSoapService  {
  public int doubler (int nombre) {
     return 2 * nombre;
  }
}

Minimal comme service !

Déploiement :

le mettre dans un répertoire serviceDoubler
mkdir serviceDoubler
cd serviceDoubler
Compilez
javac -d . TwiceSoapService.java

Ajoutez un fichier de description du service (web service descriptor)
Source de META-INF/services.xml -> donc un fichier service.xml dans le répertoire META-INF dans serviceDoubler

<service name="TwiceService" scope="application">
    <description>
        Twice Service
    </description>
    <messageReceivers>
        <messageReceiver 
            mep="http://www.w3.org/2004/08/wsdl/in-only"
            class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
        <messageReceiver
            mep="http://www.w3.org/2004/08/wsdl/in-out"
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>
    </messageReceivers>
    <parameter name="ServiceClass">
        service.twice.TwiceSoapService
    </parameter>
</service>

Créez le fichier archive du Web service :
un ensemble de fichier avec un répertoire META-INF contenant le services.xml
dans le répertoire contenant le package java et META-INF :
jar cvf TwiceService.aar *
Déployez :

arréter Tomcat
copier le fichier archive du Web service dans $CATALINA_HOME/webapps/axis2/WEB-INF/services
cp TwiceService.aar $CATALINA_HOME/webapps/axis2/WEB-INF/services
re-démarrez le server

Testez le déploiement :
- Dans un Navigateur, essayez http://localhost:8080/axis2
  pour voir si le service est proposé
- puis http://localhost:8080/axis2/services/TwiceService?wsdl
  pour découvrir le fichier WSDL du service généré par le serveur
- puis http://localhost:8080/axis2/services/TwiceService/doubler?args0=45
  pour faire un test de fonctionnement
- puis http://localhost:8080/axis2/services/TwiceService?xsd
  pour avoir le schéma des données

Un premier client RPC

Un client :

A partir du fichier wsdl du service, identifiez :

le endpoint du service
le nom de la méthode avec son namespace
les paramètres données et leur type
le type de résultat

Source de TwiceRPCClient.java -> le sauvegarder dans le répertoire clientDoubler1

package rpcclient;-> donc un fichier service.xml dans le répertoire META-INF dans serviceDoubler

import javax.xml.namespace.QName;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;

public class TwiceRPCClient {
  public static void main(String[] args)  {
    try {
      int i = Integer.valueOf(args[0]);
      RPCServiceClient serviceClient = new RPCServiceClient();
      Options options = serviceClient.getOptions();
      EndpointReference targetEPR = 
           new EndpointReference("http://localhost:8080/axis2/services/TwiceService");
      options.setTo(targetEPR);

      QName opDoubler = new QName("http://twice.service", "doubler");
      Object[] TabValeurs = new Object[] { i };
      Class[] returnTypes = new Class[] { Integer.class };
      Object[] response = serviceClient.invokeBlocking(opDoubler, TabValeurs, returnTypes);
      int result = (Integer) response[0];
      if (response == null) {
        System.out.println("PB ");
       return;
      }
      System.out.println("Doubler ( " +i+")="+result);     
    } catch (AxisFault af) {System.out.println("AxisFault " +af.getMessage());}
  }
}

les lignes de la classe :

classe Options :

comment le client communique avec le service : transport, password, timeOut ...

méthode setTo(EndpointReference) : indique le Webservice cible

classe QName : pour définir des noms qualifiés XML (avec leur nameSpace)
classe RPCServiceClient :

méthode invokeBlocking() : lance la communication SOAP et attend la réponse

classe AxisFault :

hérite d'Exception

représente les erreurs SOAP

EXECUTION

$ cd clientDoubler1
$ javac -d . TwiceRPCClient.java 
$ java rpcclient.TwiceRPCClient 4
log4j:WARN No appenders could be found for logger (org.apache.axis2.util.Loader).
log4j:WARN Please initialize the log4j system properly.
Doubler ( 4)=8

pas de log branché : c'est pas grave !

Trace de l'échange capturé par Wireshark :

POST /axis2/services/TwiceService HTTP/1.1
Content-Type: text/xml; charset=UTF-8
SOAPAction: "urn:anonOutInOp"
User-Agent: Axis2
Host: localhost:8080
Transfer-Encoding: chunked

e9
<?xml version='1.0' encoding='UTF-8'?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body><doubler xmlns="http://twice.service"><arg0 xmlns="">4</arg0></doubler></soapenv:Body></soapenv:Envelope>
0

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: text/xml;charset=UTF-8
Transfer-Encoding: chunked
Date: Sun, 05 Sep 2010 08:42:09 GMT

103
<?xml version='1.0' encoding='UTF-8'?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body><ns:doublerResponse xmlns:ns="http://twice.service"><ns:return>8</ns:return></ns:doublerResponse>
</soapenv:Body></soapenv:Envelope>
0

Un second client généré semi-automatiquement

Utilisation de l'outil wsdl2java pour générer les classes nécessaires à l'appel au web service :
wsdl2java.sh -uri http://localhost:8080/axis2/services/TwiceService?wsdl -o clientDoubler2
L'outil wsdl2java de Axis génère des classes java cliente du service en fonction du wsdl de ce service :

Ces classes sont le stub.
il est possible aussi de générer un squelette su service en java : utile si on dispose du meme service dans un autre langage et qu'on souhaite le porter sur java

Compilez les classes et générez la doc :
cd clientDoubler2
javac -d . src/service/twice/*.java
Creez la doc du stub :
javadoc -d doc src/service/twice/*.java
Consultez la doc du stub

Compilez et Executez :

Source de ClientStub.java -> le mettre dans clientDoubler2

import service.twice.TwiceServiceStub;
import service.twice.TwiceServiceStub.Doubler;
import service.twice.TwiceServiceStub.DoublerResponse;
 
public class ClientStub {
     public static void main(String[] args) throws Exception {
         service.twice.TwiceServiceStub stub = new service.twice.TwiceServiceStub();
         //Create the request
         service.twice.TwiceServiceStub.Doubler request =
              new service.twice.TwiceServiceStub.Doubler();
        request.setArgs0(45);
         //Invoke the service
        service.twice.TwiceServiceStub.DoublerResponse response 
            = stub.doubler(request);
        System.out.println("Response : " + response.get_return());
    }
}

Web service avec des données complexes

le service

Source du service Cac40Service.java -> le mettre dans un répertoire serviceCac

package cacservice;

import java.util.*;

public class Cac40Service {
    private HashMap<String, Double> map = new HashMap<String, Double>();
    public String initialisation() {
      map.put("Alstom", new Double(340.0));
      map.put("Pernod-Ricard", new Double(560.0));
      map.put("AXA", new Double(834.0));
      map.put("UPJV", new Double(666.0));
      return map.toString(); 
    } 
    public double getPrix(String symbol) {
      Double prix = (Double) map.get(symbol);
      if (prix != null)
         return prix.doubleValue();
      else
        return -1.00;
    }
    public void miseAJour(String symbol, double prix) {
      map.put(symbol, new Double(prix));
    }
    public String[] listCorbeille() {
      Set<String> corbeille = map.keySet();
      return  corbeille.toArray(new String[0]);
    }
}

Source du fichier "service descriptor" services.xml -> donc un fichier service.xml dans le répertoire META-INF dans serviceCac

<service name="Cac40Service" scope="application">
    <description>
        Cac 40 Service
    </description>
    <messageReceivers>
        <messageReceiver 
            mep="http://www.w3.org/2004/08/wsdl/in-only"
    class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
        <messageReceiver
            mep="http://www.w3.org/2004/08/wsdl/in-out"
    class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>
    </messageReceivers>
    <parameter name="ServiceClass">
        cacservice.Cac40Service
    </parameter>
</service>

déployez :
- cd serviceCac
- $CATALINA_HOME/bin/shutdown.sh
- javac -d . src/Cac40Service.java
- jar cvf Cac40Service.aar *
- cp Cac40Service.aar $CATALINA_HOME/webapps/axis2/WEB-INF/services/
- $CATALINA_HOME/bin/startup.sh

testez :

http://localhost:8080/axis2/services/Cac40Service?wsdl
...
http://localhost:8080/axis2/services/Cac40Service?xsd
....
http://localhost:8080/axis2/services/Cac40Service/listCorbeille
http://localhost:8080/axis2/services/Cac40Service/initialisation
http://localhost:8080/axis2/services/Cac40Service/listCorbeille
<ns:listCorbeilleResponse>
<ns:return>AXA</ns:return>
<ns:return>Pernod-Ricard</ns:return>
<ns:return>Alstom</ns:return>
<ns:return>UPJV</ns:return>
</ns:listCorbeilleResponse>
http://localhost:8080/axis2/services/Cac40Service/getPrix?args0=AXA
<ns:getPrixResponse>
<ns:return>834.0</ns:return>
</ns:getPrixResponse>
http://localhost:8080/axis2/services/Cac40Service/getPrix?args0=Bonux
<ns:getPrixResponse>
<ns:return>-1.0</ns:return>
</ns:getPrixResponse>
http://localhost:8080/axis2/services/Cac40Service/miseAJour?args0=Bonux&args1=100
http://localhost:8080/axis2/services/Cac40Service/getPrix?args0=Bonux
<ns:getPrixResponse>
<ns:return>100.0</ns:return>
</ns:getPrixResponse>

le client RPC :

Source du client Cac40RPCClient.java -> le mettre dans clientCac1

package rpcclient;

import javax.xml.namespace.QName;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;

public class Cac40RPCClient {
    public static void main(String[] args) throws AxisFault {
        RPCServiceClient serviceClient = new RPCServiceClient();
        Options options = serviceClient.getOptions();
        EndpointReference targetEPR = 
           new EndpointReference("http://localhost:8080/axis2/services/Cac40Service");
        options.setTo(targetEPR);

        QName op = new QName("http://cacservice", "getPrix");
        Class[] returnTypes = new Class[] { Double.class };              
        Object[] response = serviceClient.invokeBlocking(op, new Object[] {"AXA" }, returnTypes);       
        Double result = (Double) response[0];       
        if (result == null) {
            System.out.println("didn't initialize!");
            return;
        }
        System.out.println("getPrix(AXA)  = " + result.toString());
        
        op = new QName("http://cacservice", "miseAJour");
        serviceClient.invokeRobust(op, new Object[] {"Bonux", new Double(100.0)});       

        op = new QName("http://cacservice", "listCorbeille");
        String[] tabResult = {};
        returnTypes = new Class[] { tabResult.getClass() };              
        response = serviceClient.invokeBlocking(op, new Object[] {}, returnTypes);       
        tabResult = (String[]) response[0];       
        if (tabResult == null) {
            System.out.println("tabResult didn't initialize!");
            return;
        }
        System.out.println("listCorbeille : ");
        for (int i=0; i<tabResult.length; i++) 
          System.out.println("["+i+"] = " + tabResult[i].toString());          
    }
}

la méthode invokeRobust() permet l'appel de méthodes In-Only MEP (message exchange pattern)
passage de 2 arguments

EXECUTION

$ cd clientCac1
$ javac -d . src/Cac40RPCClient.java 
$ java rpcclient.Cac40RPCClient
log4j:WARN No appenders could be found for logger (org.apache.axis2.util.Loader).
log4j:WARN Please initialize the log4j system properly.
getPrix(AXA)  = 834.0
listCorbeille : 
[0] = Bonux
[1] = AXA
[2] = Pernod-Ricard
[3] = Alstom
[4] = UPJV

le client généré par wsdl2java :

$ wsdl2java.sh -uri http://localhost:8080/axis2/services/Cac40Service?wsdl -o clientCac2
Using AXIS2_HOME: /home/ferment/upjv/axis2/axis2-1.5.1
Using JAVA_HOME: /usr/lib/jvm/java-6-sun
Retrieving document at 'http://localhost:8080/axis2/services/Cac40Service?wsdl'.
$ cd clientCac2
$ javac -d . src/cacservice/*.java
Note: src/cacservice/Cac40ServiceStub.java uses unchecked or unsafe operations.
Note: Recompile with -Xlint:unchecked for details.
$ javadoc -d doc src/cacservice/*.java

Source du service ClientStub.java -> le mettre dans clientCac2

import cacservice.Cac40ServiceStub;
import cacservice.Cac40ServiceStub.GetPrix ;
import cacservice.Cac40ServiceStub.GetPrixResponse;
import cacservice.Cac40ServiceStub.ListCorbeilleResponse;
 
public class ClientStub {
     public static void main(String[] args) throws Exception {
         Cac40ServiceStub stub = new Cac40ServiceStub();
         //Create the request
         Cac40ServiceStub.GetPrix  request = new Cac40ServiceStub.GetPrix();
        request.setArgs0("AXA");
         //Invoke the service
        Cac40ServiceStub.GetPrixResponse response = stub.getPrix(request);
        System.out.println("getPrix(AXA) : " + response.get_return());
         //Invoke the service
        Cac40ServiceStub.ListCorbeilleResponse rep2 = stub.listCorbeille();
        String[] tabResult = rep2.get_return();
        System.out.println("listCorbeille : ");
        for (int i=0; i<tabResult.length; i++) 
          System.out.println("["+i+"] = " + tabResult[i].toString()); 
      }
}

EXECUTION

$ javac -d . src/ClientStub.java
$ java ClientStub
log4j:WARN No appenders could be found for logger (org.apache.axis2.description.AxisService).
log4j:WARN Please initialize the log4j system properly.
getPrix(AXA) : 834.0
listCorbeille : 
[0] = Bonux
[1] = AXA
[2] = Pernod-Ricard
[3] = Alstom
[4] = UPJV

exercices

Appelez le service Twice d'un autre ordinateur (avec son IP)
Ajoutez des fonctionnalités au Cac40 :

méthode enlever(entreprise) du cac
méthode liste des prix de toutes les actions du CAC
créez un client rpc et un client généré par wsdl2java pour tester ces nouvelles fonctions.

créer un service ToutouService :
- utilisez Chien7.java
- le service dispose d'une liste de chiens
- mettre en service la fonction initialisation de quelque chiens et la fonction getList() qui donne la liste de tous les noms des chiens
- ajouter une méthode boolean existe(Chien7) qui renvoie vrai si le chien existe dans le tableau de chiens du Toutou Service
- ajouter une méthode add(Chien7)
- ajouter une méthode find(nom) qui renvoie le Chien7 de ce nom s'il existe

AXIS

Apache AXIS

Un premier web service

Un premier client RPC

Un second client généré semi-automatiquement

Web service avec des données complexes

exercices