Web Services Xavier Blanc

Plan Principes XML (Notions) SOAP WSDL UDDI Axis Conclusion

Définition Les Web Services sont des services offerts via le web. Par exemple, un client demande le prix d’un article en envoyant un message sur le web. Ce message contient la référence de l’article. Le Web Service va recevoir la référence, effectuer le traitement du service et renvoyer le prix au client via un autre message.

Principes Pourquoi un nouveau middleware

Limitations des middleware Passage à large échelle : Web Protocoles hétérogènes  IIOP, RMI, DCOM  Firewall Pas d’ouverture des services  Notion de moteur de recherche inexistante Trop de contraintes sur le client !  Doit posséder les souches  Difficulté de construire dynamiquement

Limitations des middleware Inconvénients Intrinsèques Complexité  CORBA : IDL, Mapping, …  EJB : Container, JNDI, … Pérennité : remise en question  CORBA, EJB,.Net, … Prix  Plates-formes  Compétences

Solutions existantes Modification du Protocole  RMI / IIOP Passerelles  CORBA vers DCOM Portage d’applications existantes difficile Solutions non standards

Approche Envisagée Un nouveau Protocole : SOAP  Basé sur XML Portabilité, Hétérogénéité  Porté sur des protocoles large échelle existants HTTP, SMTP, … Paradigme orienté service : WSDL  Définition de services offerts (en XML) Découverte automatique des services (dynamicité) : UDDI  Référentiel de Web Service (Pages Jaunes, Vertes, Blanches)

Ex : ModFact SOAP / HTTP IIOP SOAP / SMTP Les clients doivent savoir envoyer des messages SOAP (sur HTTP ou SMTP) Le serveur doit savoir recevoir des messages SOAP (sur HTTP ou SMTP). Il effectue les traitements correspondant (ici délégation vers CORBA). Application existante classique (ici CORBA) UDDI Exportation du Web Service dans le référentiel UDDI Utilisation de UDDI pour construire dynamiquement des client

SOAP Protocole d’échange de messages (client / serveur) Basé entièrement sur XML Standard W3C (Initiative IBM et Microsoft)  Actuellement SOAP 1.1 Concepts  Message = Enveloppe ( Header + Body ) Extensibilité  Porté sur HTTP, SMTP, …

WSDL Langage de définition de Web Services Basé entièrement sur XML Standard W3C (Initiative IBM et Microsoft)  Actuellement WSDL 1.1 Définition de l’interface, de l’URL et du port du Web Service. Utilise le système de typage de XML Schéma

UDDI Référentiel de définitions Web Service Permet de construire dynamiquement des clients Recommandation OASIS Référentiel défini lui-même en WSDL Référentiel Public / Privé

XML Notions nécessaires pour les Web Services

Exemple de document XML le super livre 1 titre du chapitre 1 blabla blabla …

Principes Ensemble non fini de balises  L’utilisateur peut créer de nouvelles balises Définition de grammaires : XML est un Meta-Langage  MathML, NewsML, XMI, Doc, Slides, … Séparation de la forme et du fond  Un document XML peut être constitué de deux entités (le fond et la forme)

Grammaire Deux façons de définir une grammaire XML : DTD  Langage de définition de grammaire XML  Largement utilisé  Expression faible (type, structure) XML Schéma  Langage XML de définition de grammaire XML  De + en + utilisé  Expression puissante (type, structure, héritage) Un document XML est dit valide lorsqu’il est conforme à une grammaire

Espaces de noms Mécanismes permettant de partitionner les balises XML (permet d’avoir deux fois le même nom de balise) Un espace de nom est défini dans n’importe quelle balise par l’attribut xmlns et par une URI. Dans un document XML, un espace de noms est identifié par un nom logique, les balises appartenant à cet espace doivent alors être préfixée par ce nom logique. Ex : <meta:body xmlns:meta="

XML est un succès ! Standard W3C La syntaxe XML ne contient que peu de mot clef: Simplicité XML est indépendant des plates-formes: Portabilité XML est un méta-langage, il est possible de créer ses propres balises: Extensibilité Outils disponibles (et gratuits) Largement utilisé pour les échanges inter-applications

A vous de jouer ! Pouvez-vous définir un document XML qui représente un message Client/Serveur ? Quelles sont les informations que ce message doit contenir ? Comment échanger ce message ?  Quels sont les problèmes soulevés ?

SOAP Simple Object Access Protocol Version 1.1

Abstract SOAP is a lightweight protocol for exchange of information in a decentralized, distributed environment. It is an XML based protocol that consists of three parts: an envelope that defines a framework for describing what is in a message and how to process it, a set of encoding rules for expressing instances of application-defined datatypes, and a convention for representing remote procedure calls and responses. SOAP can potentially be used in combination with a variety of other protocols; however, the only bindings defined in this document describe how to use SOAP in combination with HTTP and HTTP Extension Framework.

Exemple de message StockQuote est un ensemble de services qui permet d’obtenir des informations sur des actions boursières.  GetLastTradePrice est le service qui permet de connaître la dernière valeur d’une action. Cet exemple présente un échange de messages entre un client qui veut savoir la valeur de l’action « DIS ».

Exemple de message POST /StockQuote HTTP/1.1 Host: Content-Type: text/xml; charset="utf-8" Content-Length: nnnn SOAPAction: "Some-URI" DIS Propre au portage sur HTTP

Exemple de message HTTP/ OK Content-Type: text/xml; charset="utf-8" Content-Length: nnnn 34.5 Propre au portage sur HTTP

Analyse de l’exemple Des Balises Utilisateur  GetLastTradePriceResponse  Symbol  Price Un Namespace Utilisateur  xmlns:m="Some-URI" Des Balises SOAP  Enveloppe  Body Un Namespace SOAP  xmlns:SOAP-ENV=" Des informations dans la partie HTTP

Namespace SOAP Le namespace des balises SOAP  Le namespace de l’encodage SOAP 

Structure d’un message SOAP Un message SOAP est contenu dans une balise Envelope  Une Envelope peut contenir une balise Header Une Header peut contenir n’importe quel ensemble de balises. Ces balises doivent appartenir à des namespaces.  Une Envelope doit contenir une balise Body Un Body peut contenir n’importe quelle ensemble de balises. Ces balises peuvent appartenir à des namespaces. Un Body peut contenir des balises Fault qui permettent d’identifier des erreurs. Framework

SOAP Header Mécanisme d’extension du protocol SOAP La balise Header est optionnelle Si la balise Header est présente, elle doit être le premier fils de la balise Envelope La balise Header contient des entrées Une entrée est n’importe quelle balise incluse dans un namespace Framework

SOAP Header Example 5 Framework

SOAP Body Le Body contient le message à échanger La balise Body est obligatoire La balise Body doit être le premier fils de la balise Envelope (ou le deuxième si il existe une balise Header) La balise Body contient des entrées Une entrée est n’importe quelle balise incluse optionnellement dans un namespace Une entrée peut être une Fault. Framework

SOAP Fault Balise permettant de signaler des cas d’erreur. La balise Fault contient les balises suivantes  faultcode : un code permettant d’identifier le type d’erreur Client, Server, VersionMismatch, MustUnderstand  faultstring : une explication en langage naturel  faultactor : une information identifier l’initiateur de l’erreur  detail : Définition précise de l’erreur. Framework

Encodage Un message SOAP contient des données typées. Il faut donc définir un moyen d’encoder ces données. Vocabulaire SOAP :  Value (valeur d’une donnée) Simple value (string, integers,etc) Compound value (array, struct, …)  Type (d’une value) Simple Type Compound Type Encoding

Encodage L’encodage c’est la représentation de valeurs sous forme XML. Le décodage c’est la construction de valeurs à partir d’XML L’XML qui représente les valeurs a une structure qui dépend du type des valeurs Il faut donc définir le type  Soit mécanisme définit par l’utilisateur  Soit utilisation d’XML Schéma (préconisé) Encoding

Simple Types Type (XML Schema) Valeurs 45 Blue Type XML Schema Construction de Type XML Schema Encoding

Simple Types La définition d’un XML Schéma pour tout type peut être fastidieux SOAP a défini deux façons de préciser le type d’une valeur sans définir le Schéma XML:  45  29.5 Encoding

Compound Types Une structure est un type composé dans lequel les membres sont accessibles uniquement grâce à des noms différents. Un tableau est un type composé dans lequel les membres sont accessibles uniquement grâce à leur position. Encoding

Struct Type (XML Schéma) Valeur Xavier 30 Encoding

Array Le type est directement précisé grâce aux balises SOAP: 3 4 Encoding

SOAP avec HTTP SOAP peut être facilement porté sur Http.  Convient au mode Request/Response de Http  Le message SOAP est mis dans une requête POST avec un content-type text/xml  Définition d’un header http : SOAPAction  Utilisation des codes http (2xx, 4xx, 5xx) Convention

SOAP avec HTTP POST /StockQuote HTTP/1.1 Host: Content-Type: text/xml; charset="utf-8" Content-Length: nnnn SOAPAction: "Some-URI" DIS Convention

SOAP avec HTTP HTTP/ Internal Server Error Content-Type: text/xml; charset="utf-8" Content-Length: nnnn SOAP-ENV:Server Server Error Convention

SOAP & RPC Pour faire un RPC SOAP, il faut:  L’URI de l’objet cible  Le nom de la méthode  Les paramètres de la méthode SOAP s’appuie sur le protocole d’en dessous (http) pour l’URI de l’objet. Le nom de la méthode et les paramètres sont encodés dans le message SOAP sous forme de structure. Convention

SOAP & Document L’approche RPC est de moins en moins préconisée On préfère maintenant utiliser l’approche Document qui consiste à envoyer des document XML dans les messages SOAP sans convention particulière. Convention

A vous de jouer ! Comparer SOAP par rapport à CORBA ?  IDL ?  IIOP ? SOAP est-il dédié uniquement au RPC ?  Si non, à quoi d’autre ? Quel est l’intérêt de porter SOAP sur d’autres protocoles ?

WSDL Web Services Description Language Version 1.1

Présentation Une description WSDL : 1. Décrit le type d’un service web (méthodes, types des paramètres) Cette description peut être comparée à la description IDL CORBA, elle peut servir à générer automatiquement des amorces. 2. Décrit les aspects techniques d’implantation d’un service web (quel est le protocole utilisé, quel est le l’adresse du service) Cette description sert à se connecter concrètement à un service web.

Balises Une description WSDL est un document XML qui commence par la balise definition et contient les balises suivantes :  types: cette balise décrit les types utilisés  message: cette balise décrit la structure d’un message échangé  portType: cette balise décrit un ensemble d’opérations (interface d’un service web) operation: cette balise décrit une opération réalisée par le service web. Une opération reçoit des messages et envois des messages.  binding: cette balise décrit le lien entre un protocole (http) et un portType.  service: cette balise décrit un service comme un ensemble de ports. port: cette balise décrit un port au travers duquel il est possible d’accéder à un ensemble d’opérations. Un port référence un Binding

Balises (avec XML Spy) Utilisé pour sectionner des descriptions WSDL

types Description en utilisant XML Schema. <xs:schema targetNameSpace=" xmlns:xs="

message Les messages sont envoyés entre deux interlocuteurs (ex: une opération reçoit des message et envoie des messages. Un message est composé de plusieurs part Deux façons de définir des part  Soit une part est un élément de type simple  Soit une part est un élément XML dont le type est défini dans un XML Schema

message Part de type simple Part qui utilise un XML Schema Défini dans un XML Schema

portType Un portType permet d’identifier (nommer) de manière abstraite un ensemble d’opérations. … …

operation WSDL définit 4 types d’opération :  One-Way : lorsque les opérations reçoivent des messages mais n’en n’envoient pas  Request-response : lorsque les opérations reçoivent des messages puis renvoient des messages  Solicit-response : lorsque les opérations envoient des messages puis en reçoivent  Notification : lorsque les opérations envoient des messages mais n’en reçoivent pas

operation Quelque soit le type d’opération la définition est sensiblement la même : Une opération :  Reçoit des messages :  Envoie des messages : ou La présence et l’ordre des input/outputs/fault dépendent du type de l’opération.

operation * *

binding WSDL permet de lier une description abstraite (portType) à un protocole. Chacune des opérations d’un portType pourra être liée de manière différente. Le protocole SOAP est un des protocole qui peut être utilisé. D’autres binding sont standardisés par WSDL : HTTP et MIME.

binding Un Binding :  peut être identifié par un nom : name  identifie le portType : type <wsdl:binding name="binding_name" type="nom du portType" > …

binding SOAP Pour préciser que le binding est de type SOAP, il faut inclure la balise suivante : Transport définit le type de transport  pour utiliser SOAP/HTTP Style définit la façon dont sont créer les messages SOAP de toutes les opérations  rpc : Encodage RPC défini par SOAP RPC  document : Encodage sous forme d’élément XML

binding SOAP Pour chaque opération du portType :  il faut préciser l’URI de l’opération : soapAction  Il est aussi possible de repréciser la façon dont sont créés les messages SOAP : style Pour chaque message de chaque opération, il faut définir comment sera créé le message SOAP

Exemple <soap:binding transport=" style="rpc" /> <soap:body use="encoded" encodingStyle="schemas.xmlsoap.org/soap/encoding"/> <soap:body use="encoded" encodingStyle="schemas.xmlsoap.org/soap/encoding"/>

service Un service est un ensemble de ports Un port a un portType Dans le cadre de SOAP, un port à une adresse (qui correspond à l’adresse http)

A vous de jouer Comparer WSDL à IDL ? Expliquer les dépendances entre SOAP et WSDL ? Quel est le point le plus délicat lors d’un passage à une implémentation ?

UDDI Universal Description Discovery and Integration Version 3.0

Introduction Web services are meaningful only if potential users may find information sufficient to permit their execution. The focus of Universal Description Discovery & Integration (UDDI) is the definition of a set of services supporting the description and discovery of  (1) businesses, organizations, and other Web services providers,  (2) the Web services they make available, and  (3) the technical interfaces which may be used to access those services. Based on a common set of industry standards, including HTTP, XML, XML Schema, and SOAP, UDDI provides an interoperable, foundational infrastructure for a Web services-based software environment for both publicly available services and services only exposed internally within an organization.

Rôles Un référentiel UDDI joue 3 rôles :  Pages blanches : le référentiel comporte des informations sur les fournisseurs de services.  Pages Jaunes : le référentiel comporte des critères de catégorisation de services.  Pages vertes : le référentiel comporte des informations techniques (WSDL). Les services d’un référentiel UDDI sont des Web Services !

Exemple Le référentiel UDDI de microsoft est accessible à Il est possible de parcourir ce référentiel à l’aide d’un navigateur pour :  Rechercher un service.  Ajouter un service au référentiel.

Exemple : search Façons de rechercher un service. Nous allons rechercher les Web Services de la société Amazon.

Exemple : search AmazonBusiness propose un Web Service Ce Web Service s’appelle GetBookPrice

Référentiels Type  Public : Microsoft : uddi.microsoft.com IBM : HP : uddi.hp.com SAP : udditest.sap.com  Privé ou d’entreprise Accès  Défini en WSDL  JAXR définit une API pour naviguer dans un référentiel UDDI

A vous de jouer Quel est la place d’UDDI dans les Web Services ? Comparer les référentiels UDDI avec les moteurs de recherche style Yahoo et Google ? Quel est l’intérêt des référentiels UDDI d’entreprise ?

Axis Version 1.3

Introduction Implantation OpenSource de SOAP1.1  Java Communauté Apache  Apache, Tomcat, Xerces, Struts, Cocoon Support Server  Servlet qui reçoit et envoie des messages SOAP HTTP (pont SMTP) Support Client  API pour envoyer des messages SOAP sur HTTP et SMTP

Servlet (Notion) Une Servlet est un objet Java qui fonctionne en mode requête/reponse Une Servlet http est une serlvet qui est capable de traiter des requête http et qui est capable de renvoyer des réponses http. Un moteur (container) de Servlet est une application qui reçoit des requêtes http et qui les transmet aux Servlet  Tomcat (couplage avec Apache), Websphere (couplage avec IBM http Server), Weblogic …

Architecture (Serveur) Axis fournit une Servlet (AxisServlet) qui reçoit des message SOAP sur http et qui transforme l’appel en un appel de méthode classique Java Développer un Web Service revient alors à développer un objet Java et à enregistrer ses méthodes auprès de la Servlet AxisServlet. Les clients envoient alors leurs messages SOAP sur http à AxisServlet. Pour SMTP les clients envoient leurs messages par mail à un démon. Le démon reçoit ces messages et les renvoie sur http à AxisServlet.

Architecture (Serveur) 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éveloppement d’un Web Service Développer une classe Java public class MyFirstWebService { public final String BOOK1 = "La méthode"; public final String BOOK2 = "Le Macroscope"; public int getPrice(String bookTitle) { if (bookTitle.compareTo(BOOK1)==0) { return 15; } else if (bookTitle.compareTo(BOOK2)==0) { return 20; } else return 300; }

Déploiement un Web Service Elaborer un descripteur SOAP de votre classe <deployment xmlns=" xmlns:java=" <parameter name="className« value="MyFirstWebService"/> Exporter le descripteur java org.apache.axis.client.AdminClient deploy.wsdd

Déploiement un Web Service Le fichier jws sont les équivalents des jsp pour les Web Service. Construction d’un fichier jws à partir d’une classe java:  Copy MyFirstWebService.java /…/MyFirstWebService.jws

Le Client à partir du WSDL Génération d’un ensemble de classes facilitant l’envoi de message SOAP:  java org.apache.axis.wsdl.WSDL2Java file.wsdl Classes générées:  Pour les Type  Pour les PortType  Pour les Binding  Pour les Port  Pour les Service

Le Client à partir du WSDL Construction du client :  Instancier un Service  Obtenir un Port à partir du Service  Utiliser les méthodes du Port Construire les paramètres en fonction des Types

Obtention du WSDL de l’exemple Sous axis, dans un navigateur, mettre l’adresse du Web Service suivie de ?WSDL tWebService.jws?WSDL

Les classes générées à partir de l’exemple MyFirstWebService.java MyFirstWebServiceService.java MyFirstWebServiceLocator.java MyFirstWebServiceBindingStub.java

Un exemple de Client public class Client { public static void main(String[] args) { try { MyFirstWebServiceService service = new MyFirstWebServiceServiceLocator(); MyFirstWebService port = service.getMyFirstWebService(); String st = ""; int price = port.getPrice(st); System.out.println("Le prix est : "+price); } catch (Exception ex) { ex.printStackTrace(); }

A vous de jouer Comparer cette approche avec CORBA ? A quoi sert le WSDL ? Comment se fait le mapping avec un langage de programmation ?

Conclusion Web Service : Un nouveau Buzz Word ?

Conclusion Avantages :  Des standards simples (SOAP, WSDL, UDDI)  Multi Protocole / Multi OS / Multi Langage  Paradigme de Service  Des outils (éditeurs et moteurs) Inconvénients :  Typage (pas de consensus)  Performance  Jeunesse (Sécurité, Transaction,…)

Références SOAP : WSDL : http:// UDDI : Apache SOAP :