Introduction au REST

Transcription

1 Master 2 SITW Introduction au REST Dr. Djamel Benmerzoug djamel.benmerzoug@univ-constantine2.dz Maitre de Conférences A, Département TLSI Faculté des NTIC Université Constantine 2 Abdelhamid Mehri 162

2 Introduction au REST Plan Introduction XML-RPC REST Définition Objectif Principes de REST Exemple d un RESTful Web service 163

3 Introduction Développement des WS, deux directions principales XML sur HTTP, ou ses extensions Standards WS-* Big Web services Compositional, Collaboration BPEL, WS-CDL, REST, XML-RPC,.. 164

4 Introduction XML-RPC: est un protocole d appel de procédure distante, qui utilise le langage XML pour transmettre des informations SOAP (Simple Object Access Protocol) est une spécification de protocole pour l'échange d'informations structurées entre des services Web REST (REpresentational State Transfer) utilise le protocole HTTP pour faire des appels de méthodes et vous pouvez obtenir le résultat sous forme XLM, JSON, ou autres formats. 165

5 XML-RPC XML-RPC utilise le protocole HTTP pour le transfert des données et la norme XML pour la structuration des données. Les requêtes sont exprimées en XML Envoyer les données comme une requête HTTP POST Service Web Lire la requête (XML) Traitement de la requête Retourner le résultat (XML)

6 XML-RPC Traitement de la requête et génération de résultat

7 XML-RPC : Exemple d une requête Une enveloppe HTTP qui contient un document XML décrivant la requête XML-RPC <?xml version="1.0"?> <methodcall> <methodname>examples.getstatename</methodname> <params> <param> <value><i4>25</i4></value> </param> </params> </methodcall> Code de la méthode getstatename: String getstatename(int i4){ //fetch state name from some source return statename; }

8 XML-RPC : Exemple d une réponse <?xml version="1.0"?> <methodresponse> <params> <param> <value><string>constantine</string></value> </param> </params> </methodresponse>

9 XML-RPC Avantages Simple à utiliser (contrairement à SOAP) Utilise des technologies existantes XML/HTTP Il n exige pas un langage de description (comme WSDL) Inconvénients Un service XML-RPC ignore la plupart des caractéristiques de protocole HTTP Il expose un seul URI (endpoint), et prend en charge une seule méthode sur cet URI (POST). Explicitement conçu pour une architecture RPC 170

10 REST (Définition) REST (REpresentational State Transfer) décrit un style d'architecture logicielle permettant de construire une application devant fonctionner sur des systèmes distribués, typiquement internet. REST n'est pas un protocole ni une spécification REST n est pas un standard ou une recommandation, seulement est un «design guideline» 171

11 REST (Objectif) Objectif: REST est un style d'architecture réseau pour Web Services qui met l'accent sur la définition de ressources identifiées par des URI, Il utilise les messages du protocole HTTP pour définir la sémantique de la communication client/serveur 172

12 REST (Objectif) Un des concepts important de REST est la notion de ressource. Chaque ressource est accessible par un URI (Uniform Resource Identifier) Possède au moins une représentation Possède un ou plusieurs attributs Exemples: Page web, Résumé, Une chanson, Un employé, Une imprimante, 173

13 Principes de REST Principes de REST: Identification de ressources Addressability Statelessness (sans état) Représentations de ressources Liens et connectivité interface uniforme 174

14 Principes de REST: Identification de ressources Les ressources sont identifiées par un URI Une ressource doit avoir un URI Types d'uri les plus connus sont l'urn et URL URN (Uniform Resource Name) urn:isbn: URL (Uniform Resource Locator) file:///home/username/coursjava.pdf Chaque URI désigne exactement une ressource 175

15 Principes de REST: Addressability Rendre les systèmes adressable: Une application est «adressable» si elle expose ses données comme des ressources. Exemple : Google search 176

16 Principes de REST: Statelessness (1/4) Stateless signifie que chaque requête HTTP se faite de façon complètement isolée. Quand un client fait une requête HTTP, il inclut toutes les informations nécessaires pour que le serveur peut accomplir sa demande. The REST principle says: URI needs to contain the state within it, not just a key to some state stored on the server 177

17 Principes de REST: Statelessness (2/4) The REST principle says: URI needs to contain the state within it, not just a key to some state stored on the server Un service RESTful exige que l'état reste sur le côté client Le client transmet l'état au serveur pour chaque requête Le serveur offre au client la possibilité de naviguer dans le système en envoyant chaque fois des "next links". Le serveur ne garde pas les traces des différents états du client 178

18 Principes de REST: Statelessness (3/4) Application State vs. Resource State "State" c est quoi exactement? Pensez à facebook.com Est-ce que Statelessness signifie que je dois envoyer chaque fois mes photos avec chaque requête? Deux types d'états Photos sont des ressources et elles ont des états => état d une ressource L application client accède à ces ressources et aussi elle a un état=> état de l application cliente Exemple : Ressources Google pages Web indexées Etat d une application cliente votre requête et votre page courante 179

19 Principes de REST: Statelessness (4/4) État d une ressource reste sur le serveur (par exemple, les photos sont stockées sur le serveur facebook.com) Le serveur : il ne garde pas l état de l application (libre d état) Statelessness dans REST s applique à l'état de l'application cliente Un service Web doit connaître l'état de l'application cliente (seulement) lorsque la requête est envoyée au serveur. Ici, le terme "REST". 180

20 Principes de REST: Représentations de ressources (1/2) Une ressource a besoin d'une représentation pour qu elle puisse être envoyé au client une représentation d'une ressource : certaines données sur l état actuel d'une ressource Exemple: une liste de des livres peut être représentée par un document XML, JSON, ou autre une représentation d'une ressource peut également contenir des métadonnées sur la ressource (par exemple pour les livres: le livre lui-même + métadonnées telles que l(image de couverture, commentaires, etc.) Représentation peut circuler dans l'autre sens: un client envoie une représentation d'une nouvelle ressource et le serveur crée la ressource. 181

21 Principes de REST: Représentations de ressources (2/2) Choix entre plusieurs représentations Solution 1 : Avoir un URI pour chaque représentation d'une ressource: (English) (Spanish) (French) Solution 2 : Utiliser HTTP HEAD (métadonnées) pour la négociation de contenu: expose, e.g., requête HTTP du client contient Accept-Language 182

22 Principes de REST: Liens et connectivité (1/2) Dans REST, représentations de ressources hypermédia sont = ressources (données) + des liens vers d'autres ressources Exemple: représentation de Google search: 183

23 Principes de REST: Liens et connectivité (2/2) Selon Roy Fielding : Hypermedia as the engine of application state L'état actuel d'une session HTTP n est pas stocké sur le serveur comme un état de la ressource, mais il est suivie par le client comme un état de l'application. Cette dernière est l équivalent de chemin du client à travers le Web. Le serveur guide le chemin du client en servant des hypermédias: des liens et des formes à l'intérieur des représentations de ressources. Le serveur envoie des directives aux clients pour préciser quelles sont les états possibles que les clients peuvent l atteindre à partir de l état actuel 184

24 Principes de REST: Interface uniforme (1/2) Le principe de REST "Interface Uniforme" utilise 4 méthodes HTTP sur des ressources PUT : m-à-j une ressource (URI existant). GET : Récupérer une représentation d'une ressource. POST : Créer une nouvelle ressource ou de modifier l'état d'une ressource. DELETE : Supprimer une ressource HEAD et OPTIONS Similaire au CRUD (Create, Read, Update, Delete) des opérations de bases de données 185

25 Principes de REST: Interface uniforme (2/2) 186