Exercices Soa

sentials of …

Auteur : Kevin Allen Éditeur : Emero Pty Ltd Edition : Juillet 2008 - 144 pages - ISBN : 1921523220

WSDL - M. Baron - Page 6

Généralités WSDL WSDL est l’acronyme de Web Service Description Language Basé sur le langage XML et permet de décrire un service Web Fournit une description indépendante du langage et de la plate-forme Par comparaison WSDL est assez semblable au langage IDL défini par CORBA Spécification du W3C

WSDL 1.1 : http://www.w3.org/TR/wsdl

keulkeul.blogspot.com

WSDL 2.0 : http://www.w3.org/TR/wsdl20/

A partir d’un document WSDL il est possible

Générer un client pour appeler un Service Web Générer le code pour implémenter un Service Web WSDL

- M. Baron - Page 7

Où trouver des documents WSDL Amazon Associates Web Service

https://affiliate-program.amazon.com http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl

Nécessite la création d’un compte pour l’invocation

ebaY

http://developer.ebay.com http://developer.ebay.com/webservices/finding/latest/FindingService.wsdl

Nécessite la création d’un compte pour l’invocation

National Oceanic and Atmospheric Administration

keulkeul.blogspot.com

http://www.nws.noaa.gov/xml/ http://www.weather.gov/forecasts/xml/DWMLgen/wsdl/ndfdXML.wsdl

WebserviceX.NET

http://www.webservicex.net http://www.webservicex.net/convertMetricWeight.asmx?wsdl http://www.webservicex.net/GenericNAICS.asmx?wsdl

WSDL - M. Baron - Page 8

Où est utilisé WSDL ?

Annuaire UDDI

Entreprise A interroge l’annuaire UDDI pour obtenir une liste de Services Web répondant à ces exigences

2 3

1

Entreprise A télécharge les documents qui décrivent les Services Web (WSDL)

Entreprise B publie ses Services Web qu’elle implémente dans un annuaire UDDI (transmet les WSDLs)

Entreprise A envoie des messages SOAP conformes aux WSDL pour invoquer les Services Web de B

keulkeul.blogspot.com

4 5

Entreprise A Consommatrice de Services Web

Entreprise B répond en retournant des messages SOAP conformes aux WSDL

Entreprise B Fournisseur de Services Web

WSDL - M. Baron - Page 9

Concepts d’un document WSDL Une donnée : information typée Un message : regroupe un ensemble de données Une opération : action fournie par le Service Web (~ méthode au sens Java) Un type de port : ensemble d’action (~ interface au sens Java) Un binding : définit pour un type de port le protocole utilisé

keulkeul.blogspot.com

pour transmettre les informations et le format des données Un port : définit où est localisé le Service Web et le binding à utiliser Un service : un ensemble de ports

WSDL - M. Baron - Page 10

WSDL par l’exemple : service HelloWorld Pour introduire la présentation du langage WSDL nous définissons un Service HelloWorld Le service HelloWorld fournit deux opérations

Une opération makeHello qui prend en paramètre une chaîne de caractères et retourne une chaîne caractères Une opération simpleHello sans paramètre en entrée et retourne une chaîne de caractères

keulkeul.blogspot.com

L’accès au service est réalisé par l’intermédiaire de messages SOAP (étudié en détail dans le prochain cours) Le protocole utilisé pour l’échange des messages SOAP est HTTP Le style utilisé est du RPC

WSDL - M. Baron - Page 11

WSDL par l’exemple : service HelloWorld Exemple : HelloWorld service

keulkeul.blogspot.com

WSDL - M. Baron - Page 12

WSDL par l’exemple : service HelloWorld Exemple (suite) : HelloWorld service

keulkeul.blogspot.com

WSDL - M. Baron - Page 13

Organisation d’un document WSDL

Racine d’un document WSDL

(optionnel et un seul autorisé)

Contient la définition des types des données exprimée sous forme de XML Schema

(plusieurs autorisés)

Décrit des messages à transmettre (paramètre d’une opération, valeur de retour, exception, …)

(plusieurs autorisés)

keulkeul.blogspot.com

Décrit un ensemble d’opérations où chacune à 0 ou plusieurs messages en entrée, 0 ou plusieurs messages de sortie ou de fautes

(plusieurs autorisés)

Spécifie une liaison entre un portType à un protocole (SOAP, HTTP)

(plusieurs autorisés)

Regroupe l’ensemble des ports (relation entre binding et URL)

WSDL - M. Baron - Page 14

Organisation d’un document WSDL Un document WSDL est décomposé en deux parties Partie abstraite qui décrit les messages et les opérations disponibles

Types () Messages () Types de port ()

Partie concrète qui décrit le protocole à utiliser et le type d’encodage à utiliser pour les messages

Bindings ()

keulkeul.blogspot.com

Services ()

Plusieurs parties concrètes peuvent être proposées pour la partie abstraite Motivation de cette séparation ? Réutilisabilité de la partie abstraite WSDL - M. Baron - Page 15

Organisation d’un document WSDL

Operation Op1 Operation Op1 Operation Op2 Operation Op2

Deux parties concrètes sont proposées pour un même Port Type

Partie Abstraite

Port Type 1

SOAP / HTTP SOAP / HTTP

SOAP / SMTP SOAP / SMTP

ABCBinding

DEFBinding

Des protocoles de communication différents

Port … URL …

Partie Concrète

keulkeul.blogspot.com

Port ABC URL http:// Port DEF URL http://

Port GHI URL http:// Port … URL …

Service 1

Service 2

Service 3

Des localisations différentes

WSDL Document

WSDL - M. Baron - Page 16

WSDL par l’exemple : Carnet d’adresse Le service Notebook fournit trois opérations

Une opération addPerson qui prend en paramètre un objet Person et retourne un booléen pour indiquer l’état de création Une opération addPerson qui prend en paramètre trois chaines de caractères (name, address et birthyear) sans retour Une opération getPersonByName qui prend en paramètre une chaîne de caractère et retourne un objet Person Une opération getPersons sans paramètre en entrée et qui retourne un tableau d’objets Person

keulkeul.blogspot.com

L’accès au service est réalisé par l’intermédiaire de messages SOAP (étudié en détail dans le prochain cours) Le protocole utilisé pour l’échange des messages SOAP est HTTP et le style utilisé est du RPC WSDL - M. Baron - Page 17

Elément Types L’élément contient la définition des types