1. Présentation
2. Installation plug-in eclipse
3. Axis
   1. Rappels: serveur Web J2EE
   2. Installation
   3. Travaux pratiques
      1. Services préinstallés avec Axis
         1. getVersion
         2. EchoHeaders
         3. StockQuoteService.jws
         4. Calculator.jws
      2. Le site xmethods.net
      3. Appel d'un service par client Java écrit à la main : CalcClient
      4. Déploiement avec un fichier deploy.wsdd de Axis
      5. Déploiement d'une classe Java via génération WSDL
         1. 1. Création du WSDL à partir de l'interface Java :
         2. 2. Création de squelettes Java (dans le répertoire src-gen ) à partir du WSDL :
         3. 3. Utilisation du deploy.wsdd généré à l'étape précédente pour déployer côté serveur
         4. 4. Utilisation des classes clientes générées à l'étape 2
      6. Sélection dans samples/userguide
         1. example5
4. Développement de clients à partir du WSDL
   1. Avec WSDL2Java de Axis
   2. Avec WSIF
5. Debug de services Web
   1. Moniteur Soap graphique d'Axis
6. Installation SOAPpy (Python)
   1. Python
      1. Installation de Web Services for Python
      2. Vite en train
      3. Appel WS en Python plus élaboré
7. Hyperliens
   1. Présentations
   2. Spécifications
   3. Articles, didacticiels, etc
   4. Livres
   5. Les implémentations
      1. Languages: Java, C++, Python, Perl, PHP
      2. Eclipse
      3. Divers
   6. Pages d'accueil
   7. Divers
8. Exercices
9. A VOIR
10. Annexes
    1. Installer Ant
    2. Axis à partir des sources CVS
    3. Installer JWSDP (Java Web Services Developer Pack) de Sun

Présentation

•    transparence
•    connaissance préalable
•    point de départ unique (contexte initial)
•    Passerelles

Installation plug-in eclipse

• wtp
• jem
• gef
• emf
  

Axis

Rappels: serveur Web J2EE

• API servlet
• format JSP
• archives WAR

Installation

• copier le répertoire webapps/axis/ dans $WEB_SERVER/webapps/
• facultativement copier un jar dans :
  

  $WEB_SERVER/webapps/axis/WEB-INF/lib/

•  copier le jar de xml-security (d'Apache)
  
• (re)lancer le serveur Web, ou relancer juste axis: Recharger le contexte /axis
  

Installation à partir des sources

Travaux pratiques

• Administer Axis 
• SOAPMonitor

  <servlet-mapping>
    <servlet-name>AdminServlet</servlet-name>
    <url-pattern>/servlet/AdminServlet</url-pattern>
  </servlet-mapping>

$WEB_SERVER/webapps/axis/WEB-INF/web.xml

Services préinstallés avec Axis

getVersion

• Version (wsdl)
  • getVersion

$ python
>>> import SOAPpy
>>> client = SOAPpy.SOAPProxy("http://localhost:8080/axis/services/Version")
>>> print client.getVersion()
Apache Axis version: 1.2beta
Built on Mar 31, 2004 (12:47:03 EST)

EchoHeaders

StockQuoteService.jws

>>> client = SOAPpy.SOAPProxy("http://localhost:8080/axis/StockQuoteService.jws")              
>>> print client.getQuote("XXX")
66.25

http://localhost:8080/axis/StockQuoteService.jws?method=getQuote&arg=XXX

Calculator.jws

samples/userguide/example2

$WEB_SERVER/webapps/axis/

$ wget --save-headers -O - 'http://localhost:8080/axis/Calculator.jws?method=add&i=33&j=55'
--21:54:13--  http://localhost:8080/axis/Calculator.jws?method=add&i=33&j=55
           => `-'
Résolution de localhost... complété.
Connexion vers localhost[127.0.0.1]:8080...connecté.
requête HTTP transmise, en attente de la réponse...200 OK
Longueur: non spécifié [text/xml]
HTTP/1.1 200 OK
Date: Sun, 23 May 2004 19:54:13 GMT
Server: Jetty/4.2.18 (Linux/2.4.22-1.2188.nptl i386 java/1.4.2_01)
Cache-Control: no-cache
Pragma: no-cache
Content-Type: text/xml
Connection: close

    [<=>                                                                       ] 0             --.--K/s             <?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soapenv:Body>
  <addResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
   <addReturn href="#id0"/>
  </addResponse>
  <multiRef id="id0" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
        xsi:type="xsd:int" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">88</multiRef>
 </soapenv:Body>
</soapenv:Envelope>
    [ <=>                                                                      ] 590          576.17K/s             

21:54:13 (576.17 KB/s) - « - » sauvegardé [590]

On peut voir le WSDL généré par Axis:

http://localhost:8080/axis/Calculator.jws?wsdl

Le site xmethods.net

http://services.xmethods.net/axis/getQuote?s=SUN

Appel d'un service par un client Java écrit à la main : CalcClient

setup.bat
java -classpath .;%AXISCLASSPATH% samples/userguide/example2/CalcClient add 11 22

Déploiement avec un fichier deploy.wsdd de Axis

$ cd /home/jmv/install2/axis-1_2
$ source setup.sh; echo $AXISCLASSPATH
$ cd samples/stock                                          
$ java -cp $AXISCLASSPATH org.apache.axis.client.AdminClient \
    -lhttp://localhost:8080/axis/services/AdminService deploy.wsdd
Processing file deploy.wsdd
<Admin>Done processing</Admin>

http://localhost:8080/axis/services/AdminService

org.apache.axis.client.AdminClient

axis-1_2/samples/stock

Appel d'un service par un client Java écrit à la main : GetQuote

# compiler l'exemple:
cd samples/stock; ant; cd ../..
# exécution:
java -cp $AXISCLASSPATH:build/classes/ samples.stock.GetQuote \
	-lhttp://localhost:8080/axis/servlet/AxisServlet -uuser1 -wpass1 XXX 
XXX: 55.25

import java.rmi.RemoteException;
import javax.xml.namespace.QName;
import javax.xml.rpc.Call;
import javax.xml.rpc.ParameterMode;
import javax.xml.rpc.ServiceException;
import javax.xml.rpc.encoding.XMLType;
import org.apache.axis.client.Service;

public class Client1 {	
	static void callWebService( String url, String ns, String stock_symbol ) throws ServiceException, RemoteException {
        Service  service = new Service();        
        Call  call  = service.createCall();
        
        call.setTargetEndpointAddress( url );
        call.setOperationName( new QName( ns, "getQuote" ) );
        call.addParameter( "symbol", XMLType.XSD_STRING, ParameterMode.IN );
        call.setReturnType( XMLType.XSD_FLOAT );

        Float resu = (Float)call.invoke( new Object[] {stock_symbol} );
        System.out.println(resu);
     }

     public static void main(String [] args) throws RemoteException, ServiceException {
        callWebService( "http://64.124.140.30:9090/soap", 
        		"urn:xmethods-delayed-quotes",     "SUN" );
     }
}

Déploiement d'une classe Java via génération WSDL

• Java2WSDL: Building WSDL from Java

1. Création du WSDL à partir de l'interface Java :

source setup.sh # remplit variable $AXISCLASSPATH
javac -g samples/userguide/example6/WidgetPrice.java # compile une interface
java -cp .:$AXISCLASSPATH org.apache.axis.wsdl.Java2WSDL -o wp.wsdl \
        -l"http://localhost:8080/axis/services/WidgetPrice" -n  "urn:Example6" \
        -p"samples.userguide.example6" "urn:Example6" \
         samples.userguide.example6.WidgetPrice

2. Création de squelettes Java (dans le répertoire src-gen ) à partir du WSDL :

$ java -cp $AXISCLASSPATH:. org.apache.axis.wsdl.WSDL2Java -o src-gen \
        -d Session -s -S true --testCase -Nurn:Example6 samples.userguide.example6 wp.wsdl
$ ls -l src-gen/samples/userguide/example6 
total 40
-rw-rw-r--  1 jmv jmv 1252 mai 24 17:04 deploy.wsdd
-rw-rw-r--  1 jmv jmv  672 mai 24 17:04 undeploy.wsdd
-rw-rw-r--  1 jmv jmv  451 mai 24 17:04 WidgetPrice.java
-rw-rw-r--  1 jmv jmv  556 mai 24 17:04 WidgetPriceService.java
-rw-rw-r--  1 jmv jmv 4919 mai 24 17:04 WidgetPriceServiceLocator.java
-rw-rw-r--  1 jmv jmv  539 mai 24 17:04 WidgetPriceSoapBindingImpl.java
-rw-rw-r--  1 jmv jmv 3813 mai 24 17:04 WidgetPriceSoapBindingSkeleton.java
-rw-rw-r--  1 jmv jmv 6478 mai 24 17:04 WidgetPriceSoapBindingStub.java

3. Utilisation du deploy.wsdd généré à l'étape précédente pour déployer côté serveur

cd src-gen; javac -classpath .:$AXISCLASSPATH samples/userguide/example6/*.java
java -cp .:$AXISCLASSPATH org.apache.axis.client.AdminClient \
    -lhttp://localhost:8080/axis/services/AdminService samples/userguide/example6/deploy.wsdd
 

4. Utilisation des classes clientes générées à l'étape 2

import samples.userguide.example6.*;
public class MainTest {
    public static void main (String[] args) throws Exception {
        samples.userguide.example6.WidgetPrice binding = new WidgetPriceServiceLocator().getWidgetPrice();
        ((WidgetPriceSoapBindingStub)binding).setMaintainSession(true);
        try {
            ((WidgetPriceSoapBindingStub) binding).setWidgetPrice("FOO", "$1.00");
        } catch (java.rmi.RemoteException re) {
            throw new Exception("Remote Exception caught: " + re );
        }
        try {
            java.lang.String value = null;
            value = binding.getWidgetPrice("FOO");
            System.out.println("value: " + value);
            if (value == null ||
                !value.equals("$1.00"))
                System.out.println("Wrong Price" + value);
        } catch (java.rmi.RemoteException re) {
            throw new Exception("Remote Exception caught: " + re );
        }
    }
}

Sélection dans samples/userguide

example5

<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
    <service name="OrderProcessor" provider="java:RPC">
        <parameter name="className" value="samples.userguide.example5.BeanService"/>
        <parameter name="allowedMethods" value="processOrder"/>
        <beanMapping qname="myNS:Order" xmlns:myNS="urn:BeanService" 
           languageSpecificType="java:samples.userguide.example5.Order" />
    </service>
</deployment>

Développement de clients à partir du WSDL

Avec WSDL2Java de Axis

Avec WSIF

for f in build/lib/*.jar lib/*.jar; do CLASSPATH=$CLASSPATH:$f ; done
CLASSPATH=$CLASSPATH:./build/samples

java clients.DynamicInvoker 'http://localhost:8080/axis/services/Version?wsdl' getVersion
Reading WSDL document from 'http://localhost:8080/axis/services/Version?wsdl'
Preparing WSIF dynamic invocation
- WSIF0006W: Plusieurs WSIFProvider trouvés, supportant l' URI du même espace de nom 'http://schemas.xmlsoap.org/wsdl/soap/'. ('org.apache.w
sif.providers.soap.apacheaxis.WSIFDynamicProvider_ApacheAxis, org.apache.wsif.providers.soap.apachesoap.WSIFDynamicProvider_ApacheSOAP') tro
uvé.  
- WSIF0007I: Utilisation de WSIFProvider 'org.apache.wsif.providers.soap.apacheaxis.WSIFDynamicProvider_ApacheAxis' pour namespaceURI 'http:
//schemas.xmlsoap.org/wsdl/soap/'.
Executing operation getVersion
Result:
getVersionReturn=Apache Axis version: 1.2RC1
Built on Sep 26, 2004 (06:07:18 CEST)

Done!

Debug de services Web

Moniteur Soap graphique d'Axis

admin mot_de_passe

source ./setup.sh
echo  $AXISCLASSPATH
java -classpath $AXISCLASSPATH org/apache/axis/utils/SOAPMonitor \
	-l http://localhost:8080/axis/servlet/AxisServlet 
	-u admin -w mot_de_passe &

Installation SOAPpy (Python)

Python

apt-get install python-docs
export PYTHONDOCS=/usr/share/doc/python-docs-2.2.3/html

Installation de Web Services for Python

• Web Services for Python
• [pas testé] PyAxis PyAxis is a Python program for creating and deploying web services written in Python to Apache Axis, the Java SOAP server.

• fpconst
• http://pyxml.sourceforge.net/

Vite en train

import SOAPpy
def hello():
  return "Hello World"

server = SOAPpy.SOAPServer(("localhost", 8080))
server.registerFunction(hello)
server.serve_forever()

import SOAPpy
client = SOAPpy.SOAPProxy("http://localhost:8080/")
print client.hello()

Appel WS en Python plus élaboré

>> help("SOAPpy.SOAPProxy")
Help on class SOAPProxy in SOAPpy:

SOAPpy.SOAPProxy = class SOAPProxy
 |  ################################################################################
 |  # SOAP Proxy
 |  ################################################################################
 |  
 |  Methods defined here:
 |  
 |  _SOAPProxy__call = __call(self, name, args, kw, ns=None, sa=None, hd=None, ma=None)
 |  
 |  __getattr__(self, name)
 |  
 |  __init__(self, proxy, namespace=None, soapaction=None, header=None, methodattrs=None, transport=<class SOAPpy.Clie
nt.HTTPTransport>, encoding='UTF-8', throw_faults=1, unwrap_results=None, http_proxy=None, config=<SOAPpy.Config.SOAPC
onfig instance>, noroot=0, simplify_objects=None)
 |  
 |  _callWithBody(self, body)
 |  
 |  invoke(self, method, args)

<SOAP-ENV:Body>
  <ns1:getQuote xmlns:ns1="urn:xmethods-delayed-quotes"
   SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <symbol xsi:type="xsd:string">IBM</symbol>
  </ns1:getQuote>
</SOAP-ENV:Body>

import SOAPpy
client = SOAPpy.SOAPProxy("http://66.28.98.121:9090/soap",
           namespace="urn:xmethods-delayed-quotes" )
print client.getQuote(symbol="IBM")

Hyperliens

• http://www.xmethods.net
• http://www.webservices.org
• http://www.ibm.com/developerworks/webservices/
• http://msdn.microsoft.com/soap
• http://www.develop.com/soap
• http://www.soapware.org/
• http://www.ws-i.org/
  

Présentations

• Services WEB (ESSI, Jeremy Fierstone, 116 pages)
  
• PowerPoint Presentation - Omar Benjelloun - INRIA - DEA I3. 62. 31 janvier 2003. SOAP, WSDL, UDDI (63 pages)
• Webservices Delacrétaz Jean-Marc. Les 3 outils SOAP, WSDL et UDDI (www.hec.unil.ch , 43 pages)
• Title - une vue Microsoft des choses
• http://www.javapassion.com/webservices/SOAP4.pdf - une vue Sun des choses

Spécifications

W3C SOAP page : SOAP Specification Document - SOAP Version 1.2 Part 0: Primer.

Web Services Description Language (WSDL) 2.0

Note W3C WSDL 1.1 Web Services Description Language (WSDL) Specification Documents

• XML-Signature Syntax and Processing;
• XML Encryption Syntax and Processing.

Once these are implemented, XML Key Management is likely to be the next focus for the project.

Articles, didacticiels, etc

The Java Web Services Tutorial

Livres

Les implémentations

Languages: Java, C++, Python, Perl, PHP

• Axis (Java et C++)
• http://java.sun.com/webservices/jwsdp/index.jsp - Java Web Services Developer Pack (Java WSDP)
• implémentation de référence Sun
  
• gSOAP Toolkit The gSOAP toolkit is a cross-platform development environment for C and C++ SOAP/XML Web services (SOAP 1.1/1.2, WSDL 1.1). gSOAP supports XML serialization of native C/C++ data types. Includes stub/skeleton compiler, HTTP Web server, and much more.
  
• Web Services for Python (pywebsvcs)- Web services for Python programmers, both client and servers. This includes SOAP, WSDL, UDDI, etc.
• SOAP::Lite SOAP::Lite is a collection of Perl modules that provides a simple and lightweight implementation of SOAP, XML-RPC, UDDI and other webservice-related specifications. 
• NuSOAP - SOAP Toolkit for PHP NuSOAP is a rewrite of SOAPx4, provided by NuSphere and Dietrich Ayala. It is a set of PHP classes - no PHP extensions required - that allow developers to create and consume web services based on SOAP 1.1, WSDL 1.1 and HTTP 1.0/1.1. Manual PHP 5 en Français : SOAP
  
• SOAP server class - A PHP class to build SOAP servers.
• Web Service Library for Eiffel Codename Goanna. This project provides a web services library for Eiffel. The library contains clusters that support servlets, end-points (HTTP, CGI, FastCGI), XML-RPC, SOAP, logging (log4e), DOM Level 2, and XML to DOM parsing.
  
• O'Reilly Network: Using the Mozilla SOAP API - ... SOAP messages and connecting with Web services ... A Web application running in Mozilla ... Mozilla's SOAP API is a JavaScript interface
• wiki XULfr - Web Services/Xml Rpc ... permet d'effectuer des appels de services web en xml
  
  

Eclipse

• ObjectWeb Forge: Project Info- Lomboz
• Eclipse WSDL2Java plugin This project provides an eclipse import wizard which generates the java client stubs to invoke a Web Service. (Add Web Reference) The user friendly wizard invokes the Apache WSDL2Java tool: "Building stubs, skeletons, and data types from WSDL" .
  WSDL2Java Web Service (0.82217205)
  A plug-in to generate client-side bindings to a Web service using the Apache AXIS WSDL2Java tool. more
  
• SoapClipse SoapClipse is an Eclipse plugin for Axis 1.2alpha. It adds a WSDL2Java wizard to the Eclipse IDE available through right-clicking on any *.wsdl file in your project. Future releases, coming soon, will add more access points to the wizard.

Divers

• Apache WSIF - A WSDL-based API for invoking WSDL-described services.
• xinco - A Web-Service based (SOAP) information and document management system.
• CherryPy CherryPy is a tool to develop web services. It is based exclusively on Python and uses many powerful concepts, which makes it unique in its approach to website development. CherryPy sits in between a compiler and an application server.
  
• Xydra - An automatic form generator for Web Services
• UDDI server in java. Being a part of a bigger goal, right now this project consists of an open source java implementation of the UDDI version 2.0 server.
•   SOAP to CORBA bridging software Generic SOAP to CORBA bridging software, using the CORBA Interface repository to match the incoming SOAP request to the corresponding CORBA service, build the dynamic invocation of the CORBA service and to generate the SOAP response or possibly SOAP fault
• Dox Discovery Servlet Dox Discovery is an attempt to bring elegance and simplicity to finding and using networked services. It uses Rendezvous/Zeroconf technology to auto-discover networked web services and generetes either an RSS site feed or a pretty web page. 88.46%
• 
  

• Algorithm::Evolutionary	Algorithm::Evolutionary provides classes for performing simple evolutionary computation tasks, including definition of objects from XML and SOAP support. It should be interoperable with other EC libraries using SOAP.
  SMUD (SOAP-able Multi User Dungeon)	This project will be used to create a multi-user dungeon (MUD) loosly based on the "Dungeons & Dragons" world. The most important aspect of this server is that it accepts client connections via SOAP/XML envelopes. Fun.

Pages d'accueil

Divers

Google Web APIs - Home - [ Traduire cette page ]

WebServices.Org - The Web Services Industry Portal - - [ Traduire cette page ]

WebServices - Axis - [ Traduire cette page ]

developerWorks : Web services - [ Traduire cette page ]

Web Services Developer Center Home - [ Traduire cette page ]

WSDL, SOAP, Web Services Search Engine and Web Service Tracking - [ Traduire cette page ]

Exercices

A VOIR

• sécurité
• WS choreography
• Générer des formulaires à partir de WSDL (devrait être possible en XSLT ou XQuery)
• comment enrober des services RMI ou Corba en WS
  
• SOAP avec eXist
• renvoyer des objets complexes
• accéder au contexte servlet
• Services web asynchrones

Annexes

Installer Ant

• Télécharger le zip depuis ant.apache.org
• déziper
• créer variables d'environnement:
  

  export ANT_HOME=
  export JAVA_HOME=

• copier $ANT_HOME/bin/ant dans un répertoire déjà dans le path
  

Axis à partir des sources CVS

cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login
cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout ws-axis
cd java
unset CLASSPATH
ant war
[...]
war:
     [copy] Copying 8 files to /usr/src/ws-axis/java/build/webapps/axis/WEB-INF/lib
     [copy] Copying 27 files to /usr/src/ws-axis/java/build/webapps/axis/samples
     [copy] Copied 21 empty directories to 13 empty directories under /usr/src/ws-axis/java/build/webapps/axis/samples
     [copy] Copying 56 files to /usr/src/ws-axis/java/build/webapps/axis/WEB-INF/classes/samples
      [jar] Building jar: /usr/src/ws-axis/java/build/axis.war

BUILD SUCCESSFUL
cp build/axis.war $WEBAPPS  # déployer Axis

Installer JWSDP (Java Web Services Developer Pack) de Sun

Java(TM) Web Services Developer Pack 1.4 sera installé à l'emplacement ci-après :
/home/jmv/usr2/jwsdp-1.4
avec les fonctions suivantes :
XML Digital Signature Version 1.0 EA XML and Web Services Security Version 1.0 EA3 WS-I Attachments Sample Application Version 1.0 EA JAXB Version 1.0.3 (Java Architecture for XML Binding) JAXP Version 1.2.6 (Java API for XML Processing) JAXR Version 1.0.6 (Java API for XML Registries) JAX-RPC Version 1.1.2 (Java API for XML-based RPC) SAAJ Version 1.2.1 (SOAP with Attachments API for Java) JSTL Version 1.1 (JavaServer Pages(TM) Standard Tag Library) Java WSDP Registry Server Version 1.0_06
pour une taille totale de :
75 Mo

In this version of Java(TM) Web Services Developer Pack, the org.apache JAXP packages have been renamed.  
As a result, the use of the java.endorsed.dirs system property is no longer necessary for 
standalone Java(TM) applications which use JDK 1.4.x to work.  
If you write standalone Java applications, all that is now needed is to include the JAXP jar files 
at the beginning of the CLASSPATH.

jwsdp-1.4/docs/GettingStarted.html

/home/jmv/usr2/tomcat-jwsdp-1.4/bin/catalina.sh start

augroup filetypedetect
     au! BufNewFile,BufRead *.wsdd     setf xml
augroup END