Transcript Web Services
Web Services
Xavier Blanc [email protected]
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
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).
SOAP / HTTP IIOP SOAP / SMTP
Application existante classique (ici CORBA)
UDDI
Utilisation de UDDI pour construire dynamiquement des client Exportation du Web Service dans le référentiel UDDI
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
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 conforme
à une grammaire lorsqu’il est
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 : 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 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 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. 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 ». POST /StockQuote HTTP/1.1 Host: www.stockquoteserver.com Content-Type: text/xml; charset="utf-8" Content-Length: nnnn SOAPAction: "Some-URI" Propre au portage sur HTTP HTTP/1.1 200 OK Content-Type: text/xml; charset="utf-8" Content-Length: nnnn Propre au portage sur HTTP Des Balises Utilisateur GetLastTradePriceResponse Symbol Price Un Namespace Utilisateur xmlns:m="Some-URI" Des Balises SOAP Enveloppe Body Un Namespace SOAP xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" Des informations dans la partie HTTP Le namespace des balises SOAP http://schemas.xmlsoap.org/soap/envelope Le namespace de l’encodage SOAP http://schemas.xmlsoap.org/soap/encoding Framework 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 des erreurs. Fault qui permettent d’identifier Framework 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 Framework 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 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. Encoding 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 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 Type (XML Schema) Encoding 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: Encoding 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. Type (XML Schéma) Encoding Encoding Le type est directement précisé grâce aux balises SOAP: Convention 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 POST /StockQuote HTTP/1.1 Host: www.stockquoteserver.com Content-Type: text/xml; charset="utf-8" Content-Length: nnnn SOAPAction: "Some-URI" Convention HTTP/1.1 500 Internal Server Error Content-Type: text/xml; charset="utf-8" Content-Length: nnnn Convention 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 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. 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 ? Web Services Description Language Version 1.1 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. 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 Utilisé pour sectionner des descriptions WSDL Description en utilisant XML Schema. < wsdl:types > wsdl:types > 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 Part de type simple Un portType permet d’identifier (nommer) de manière abstraite un ensemble d’opérations. 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 Quelque soit le type d’opération la définition est sensiblement la même : Une opération : Reçoit des messages : input name=" nom_optionel " message=" nom_message " /> output name=" nom_optionel " message=" nom_message " /> input name=" nom_optionel " message=" nom_message " /> fault name=" nom_optionel " message=" nom_message " />* input name=" nom_optionel " message=" nom_message " /> output fault name=" name=" nom_optionel nom_optionel " message=" " message=" nom_message nom_message " /> " />* 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. Un Binding : peut être identifié par un nom : name identifie le portType : type name =" binding_name " type =" nom du portType " > … Pour préciser que le binding est de type SOAP, il faut inclure la balise suivante : 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 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) < wsdl:service name=“MonService"> /wsdl:service > 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 ? 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. 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 ! Le référentiel UDDI de microsoft est accessible à http://uddi.microsoft.com 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. Façons de rechercher un service. Nous allons rechercher les Web Services de la société Amazon. AmazonBusiness propose un Web Service Ce Web Service s’appelle GetBookPrice Type Public : Microsoft : uddi.microsoft.com IBM : www.ibm.com/services/uddi 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 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 ? 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 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 … 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. 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. SOAP/HTTP AxisServlet Le client envoie des messages SOAP/HTTP Moteur de Servlet JVM Objets Java et Servlet sont dans la même JVM (pas de répartition). } 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; Elaborer un descripteur SOAP de votre classe 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 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 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 Sous axis, dans un navigateur, mettre l’adresse du Web Service suivie de ?WSDL http://localhost:8080/axis/jwspages/MyFirs tWebService.jws?WSDL MyFirstWebService.java MyFirstWebServiceService.java MyFirstWebServiceLocator.java MyFirstWebServiceBindingStub.java } 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(); } Comparer cette approche avec CORBA ? A quoi sert le WSDL ? Comment se fait le mapping avec un langage de programmation ? 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,…) SOAP : http://www.w3.org/TR/SOAP/ WSDL : http://www.w3.org/TR/2001/NOTE-wsdl 20010315 UDDI : http://www.uddi.org/ Apache SOAP : http://xml.apache.org/soap/XML est un succès !
A vous de jouer !
SOAP
Simple Object Access Protocol
Version 1.1
Abstract
Exemple de message
Exemple de message
Exemple de message
Analyse de l’exemple
Namespace SOAP
Structure d’un message SOAP
SOAP Header
SOAP Header Example
SOAP Body
SOAP Fault
Encodage
Encodage
Simple Types
Simple Types
Compound Types
Struct
Array
SOAP avec HTTP
SOAP avec HTTP
SOAP avec HTTP
SOAP & RPC
SOAP & Document
A vous de jouer !
WSDL
Présentation
Balises
Balises (avec XML Spy)
types
message
message
portType
operation
operation
operation
binding
binding
binding SOAP
binding SOAP
Exemple
service
A vous de jouer
UDDI
Universal Description Discovery and Integration
Version 3.0
Introduction
Rôles
Exemple
Exemple : search
Exemple : search
Référentiels
A vous de jouer
Axis
Version 1.3
Introduction
Servlet (Notion)
Architecture (Serveur)
Architecture (Serveur)
Développement d’un Web Service
Déploiement un Web Service
Déploiement un Web Service
Le Client à partir du WSDL
Le Client à partir du WSDL
Obtention du WSDL de l’exemple
Les classes générées à partir de l’exemple
Un exemple de Client
A vous de jouer
Conclusion
Web Service : Un nouveau Buzz Word ?
Conclusion
Références