WSDL

Web Services Description Language

décrit et localise les webs services
écrit en XML
standard W3C avec norme 1.1 et la 2.0

Structure d"un Fichier WSDL

le document Wsdl décrivant un web service :

<definitions>
  <types>
    définition des types
    les types de données des valeurs transmises
    exprimés en XSD la syntaxe XML Schema
    ........
  </types>
  <message>
    définition des messages
    noms et types des paramètres in, ou et in-out
    ....
  </message>
  <portType>
    définition des ports/portTypes
    noms des opérations/méthodes et leurs messages
    .......
  </portType>
  <binding>
    définition des liaisons (binding)
    type de transport pour chaque portType
    ....
  </binding>
  <service>
    définition des ports 
    <port ..../> associe un "endpoint" et une liaison
    <port ..../>
    ......
  </service>
</definitions>

Dans un service RPC, portType-message-types définit la signature d'une méthode distante,alors que le binding définit l'implémentation pour le transport de l'appel.

 <message name="IntToRoman0Request">
    <part name="Int" type="xs:int"/>
  </message>
  <message name="IntToRoman0Response">
    <part name="return" type="xs:string"/>
  </message>
  <message name="RomanToInt1Request">
    <part name="Rom" type="xs:string"/>
  </message>
  <message name="RomanToInt1Response">
    <part name="return" type="xs:int"/>
  </message>
  <portType name="IRoman">
    <operation name="IntToRoman">
      <input message="tns:IntToRoman0Request"/>
      <output message="tns:IntToRoman0Response"/>
    </operation>
    <operation name="RomanToInt">
      <input message="tns:RomanToInt1Request"/>
      <output message="tns:RomanToInt1Response"/>
    </operation>
  </portType>

signifie :
string IntToRoman(int Int)
int RomanToInt(string Rom)

  <binding name="IRomanbinding" type="tns:IRoman">
    <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="IntToRoman">
      <soap:operation soapAction="urn:Roman-IRoman#IntToRoman" style="rpc"/>
      <input message="tns:IntToRoman0Request">
        <soap:body use="encoded" encodingStyle=.... />
      </input>
      <output message="tns:IntToRoman0Response">
        <soap:body use="encoded" encodingStyle=..../>
      </output>
    </operation>
    <operation name="RomanToInt">
      <soap:operation soapAction="urn:Roman-IRoman#RomanToInt" style="rpc"/>
      <input message="tns:RomanToInt1Request">
        <soap:body use="encoded" encodingStyle=.... />
      </input>
      <output message="tns:RomanToInt1Response">
        <soap:body use="encoded" encodingStyle=..../>
      </output>
    </operation>
  </binding>
  <service name="IRomanservice">
    <port name="IRomanPort" binding="tns:IRomanbinding">
      <soap:address location="http://www.ebob42.com/cgi-bin/Romulan.exe/soap/IRoman"/>
    </port>
  </service>

La liaison et le service définissent que :
le port d'"endpoint" http://www.ebob42.com/cgi-bin/Romulan.exe/soap/IRoman est transporté en utilisant SOAP sur HTTP selon un mode RPC et offre les 2 méthodes précisées avant.

4 types d'opération :
- One-way émission sans requete
- Request-response requete avec réponse synchrone
- Solicit-response requete avec réponse asynchrone
- Notification envoi simple
2 styles de transmissions : RPC et DOC
La Sécurité des transactions est basées sur plusieurs normes dont :
XML Encryption : mécanisme d'encryptage et de décryptage des documents XML.
XML Signature : implémentation des signatures digitales dans les documents XML.

Analyse de fichiers WSDL

Avec le site http://www.xmethods.net/
Liste de service Soap :
Publisher -- Style -- Service Name -- Description
PeterM -- RPC -- Toto und Harry -- ballern bechern bumsen - Ein Satz im Revier
isontheline -- RPC -- BerreWeather -- Get weather report for major cities around the Etang de Berre.
AbuRasheed -- RPC -- QuranService -- Get Verses from the Quran
b.swart -- RPC -- Romulan Numbers XLII -- Convert roman numbers <-> digital numbers
Essayez Romulan Numbers XLII
- Voici la description :
  WSDL http://www.ebob42.com/cgi-bin/Romulan.exe/wsdl/IRoman Analyze WSDL | View RPC Profile (only for RPC services)
  SOAP Binding IRomanbinding
  Key uuid:BF3EFCDD-FCD4-8867-3AAC-068985E7CB89
  Owner: b.swart
  For more Info: http://www.drbob42.com
  Description: Convert roman numbers <-> digital numbers
- essayez View RPC :
  - Voici la description :
    Method Name IntToRoman
    Endpoint URL http://www.ebob42.com/cgi-bin/Romulan.exe/soap/IRoman
    SOAPAction urn:Roman-IRoman#IntToRoman
    Method Namespace URI urn:Roman-IRoman
    Input Parameters
    Int int
    Output Parameters
    return string
    
    Method Name RomanToInt
    Endpoint URL http://www.ebob42.com/cgi-bin/Romulan.exe/soap/IRoman
    SOAPAction urn:Roman-IRoman#RomanToInt
    Method Namespace URI urn:Roman-IRoman
    Input Parameters
    Rom string
    Output Parameters
    return int
  - essayez aussi Analyze WSDL
  - Essayez try it pour lancer une requete

Exercice

WSDL :
Découvrez et essayez d'autres services du site XMethods