REST
Representational State Transfer
Module SOA
A.U 2014-2015
Objectifs
Comprendre le style d’architecture REST.
Comprendre les différences entre les services web étendus (SOAP) et les
services web REST.
Rest 2
Plan
• Présentation de REST
• Motivation pour REST
• Principes de REST
• Différences entre SOAP et REST
• Développement de services web REST java
Rest 3
Présentation de REST 1/2
 REST est l’acronyme de REpresentational State Transfert
 Principe défini dans la thèse de Roy FIELDING en 2000
-Il est l’un des principaux auteurs de la spécification HTTP
-Il est le développeur du serveur Web Apache
 REST est un style d’architecture inspiré de l’architecture du Web pour construire
des services web
Un style d’architecture est un ensemble de contraintes qui
permettent, lorsqu’elles sont appliquées aux composants
d’une architecture, d’optimiser certains critères propres au
cahier des charges du système à concevoir.
Rest 4
 REST n’est pas:
- un format
- un protocole
- un standard
Bien que REST ne soit pas un standard, il utilise des standards:
- HTTP
- URL
- XML/HTML
Présentation de REST 2/2
Rest 5
Motivation pour REST 1/2
 REST est une alternative à SOAP
 En 2006, Google a abandonné son API SOAP au profit d'une API simplifiée
REST
Source:
http://www.google.com/trends/explore?hl=fr#q=rest%20api%2Csoap%20api&cmpt=q
Rest 6
 REST est léger et simple :
– Les messages sont courts, faciles à décoder par le navigateur et par le
serveur d’application.
 REST est auto-descriptif :
vous pouvez naviguer à travers ses ressources comme vous le
feriez avec une page Web. Il y a une URL intuitive unique pour
chaque ressource. On peut facilement en déduire la structure des
ressources sans avoir besoin de beaucoup de documentation.
 REST est stateless :
– Consommation de mémoire inférieure
 REST peut être géré en cache
– mise en cache possible donc meilleure montée en charge
Motivation pour REST 2/2
Rest 7
Représentation
URI
Ressource
http://weather.com/tunishttp://weather.com/tunis
La météo de TunisLa météo de Tunis
Représente
Identifie
Principes de REST 1/7
Rest 8
 Une ressource
 Un identifiant de ressource
 Une représentation de la ressource
 Interagir avec les ressources
– Requêtes HTTP : GET, POST, PUT et DELETE
Principes de REST 2/7
Rest 9
Ressources (Identifiant)
•Identifié par une URI
Exemple : http://localhost:8080/libraryrestwebservice/books
Méthodes (Verbes)
• pour manipuler la ressource
• Méthodes HTTP : GET, POST, PUT and DELETE
Représentation
• donne une vue sur l’état de la ressource
• informations transférées entre le client et le serveur
Exemples : XML, Text, JSON, …
Principes de REST 3/7
Rest 10
Méthodes
•Une ressource quelconque peut subir quatre opérations de base désignées par
CRUD
 Create (Créer)
 Retrieve (Lire)
 Update (mettre à jour)
 Delete (Supprimer)
•REST s’appuie sur le protocole HTTP pour exprimer les opérations via les méthodes
HTTP
 Create POST
 Retrieve GET
 Update PUT
 Delete DELETE
Principes de REST 4/7
Rest 11
Méthodes
• Méthode GET fournit la représentation de la ressource
GET: /produits/tv
HTTP status: 200 (OK)
ReprésentationClient Serveur
• Méthode POST crée une ressource
POST: /produits/tv
Représentation dans le corps
Client
HTTP status: 201 (Created)
Serveur
Principes de REST 5/7
Rest 12
Méthodes
• Méthode DELETE supprime une ressource
DELETE: /produits/tv/2
HTTP status: 200 (OK)
Client Serveur
• Méthode PUT met à jour une ressource
PUT: /produits/tv/2
Représentation dans le corps
Client
HTTP status: 200 (Ok)
Principes de REST 6/7
Serveur
Rest 13
Fournir les données suivant une représentation pour:
• le client (GET): format de sortie
• le serveur (PUT et POST): format d’entrée
La représentation d’une ressource peut prendre différents formats:
• XML
• JSON
• Text
•…
Le format d’entrée (PUT et POST) et le format de sortie (GET) d’un service Web d’une
ressource peuvent être différents
Principes de REST 7/7
Représentation
Rest 14
WADL 1/2
 Web Application Description Language
 est un langage de description XML de services de type REST
 est une spécification W3C initiée par SUN
 l’objectif est de pouvoir générer automatiquement les APIs clientes d’accès aux
services REST
Remarques
-Peu d’outils exploite la description WADL
-Apparu bien plus tard
Rest 15
Exemple
WADL 2/2
Rest 16
Service web étendus VS REST 1/5
 Services web REST sont orientés ressource
Les mêmes opérations quelque
soit la resource
Les opérations dépendent des
types des activités
 Services web étendus sont orientés activité
Rest 17
Protocole de communication
Message SOAP
Client Serveur
 Services web étendus
Service web étendus VS REST 2/5
 REST
Requête/Réponse HTTP
Client Serveur
Rest 18
Service web étendus VS REST 3/5
Services web étendus Services web REST
Exposition des
opérations
Exposition des
ressources
Protocole de
communication
SOAP HTTP
Protocole de transport HTTP, autres HTTP
Description des
interfaces
WSDL WADL
Format des données XML XML, Text, JSON…
Rest 19
Service web étendus VS REST 4/5
Rest 20
Services Web REST
Avantages
-Simplicité
-Lisibilité par l’humain
-Représentations
multiples
Inconvénients
-Sécurité restreinte
Services Web étendus
Avantages
-Standardisé
-Sécurité (WS-Security)
-Outillé
Inconvénients
-Complexité, lourdeur
Service web étendus VS REST 5/5
Rest 21
Services Web REST avec Java
 JAX-RS: Java API for RESTful Web Services
 Spécification décrivant la mise en œuvre des services web REST
 JAX-RS est basé sur les annotations
@Path définit le chemin de la ressource. Cette
annotation se place sur la classe et/ou sur la
méthode implémentant le service.
@GET, @PUT,
@POST,
@DELETE
définit l’action implémentée par le service
@Produces spécifie le type de la réponse du service
@Consumes spécifie le type accepté en entré du service
Rest 22
Services Web REST avec Java
 Différentes implémentations de JAX-RS sont disponibles:
• JERSEY (Oracle)
• CXF (Apache)
• RESTEasy (JBoss)
• RESTlet
 Seule l’approche bottom-up est possible
• Annoter une classe POJO
• Compiler et déployer
 JAX-RS se limite à l'implémentation serveur, la spécification ne propose rien d
côté client.
Rest 23
En résumé
• REST est un style d’architecture
• REST est une alternative aux services web étendus (SOAP)
• REST se base sur le protocole HTTP
• JAX-RS est l’API java permettant de développer des services web REST
Rest 24

7 rest

  • 1.
  • 2.
    Objectifs Comprendre le styled’architecture REST. Comprendre les différences entre les services web étendus (SOAP) et les services web REST. Rest 2
  • 3.
    Plan • Présentation deREST • Motivation pour REST • Principes de REST • Différences entre SOAP et REST • Développement de services web REST java Rest 3
  • 4.
    Présentation de REST1/2  REST est l’acronyme de REpresentational State Transfert  Principe défini dans la thèse de Roy FIELDING en 2000 -Il est l’un des principaux auteurs de la spécification HTTP -Il est le développeur du serveur Web Apache  REST est un style d’architecture inspiré de l’architecture du Web pour construire des services web Un style d’architecture est un ensemble de contraintes qui permettent, lorsqu’elles sont appliquées aux composants d’une architecture, d’optimiser certains critères propres au cahier des charges du système à concevoir. Rest 4
  • 5.
     REST n’estpas: - un format - un protocole - un standard Bien que REST ne soit pas un standard, il utilise des standards: - HTTP - URL - XML/HTML Présentation de REST 2/2 Rest 5
  • 6.
    Motivation pour REST1/2  REST est une alternative à SOAP  En 2006, Google a abandonné son API SOAP au profit d'une API simplifiée REST Source: http://www.google.com/trends/explore?hl=fr#q=rest%20api%2Csoap%20api&cmpt=q Rest 6
  • 7.
     REST estléger et simple : – Les messages sont courts, faciles à décoder par le navigateur et par le serveur d’application.  REST est auto-descriptif : vous pouvez naviguer à travers ses ressources comme vous le feriez avec une page Web. Il y a une URL intuitive unique pour chaque ressource. On peut facilement en déduire la structure des ressources sans avoir besoin de beaucoup de documentation.  REST est stateless : – Consommation de mémoire inférieure  REST peut être géré en cache – mise en cache possible donc meilleure montée en charge Motivation pour REST 2/2 Rest 7
  • 8.
    Représentation URI Ressource http://weather.com/tunishttp://weather.com/tunis La météo deTunisLa météo de Tunis Représente Identifie Principes de REST 1/7 Rest 8
  • 9.
     Une ressource Un identifiant de ressource  Une représentation de la ressource  Interagir avec les ressources – Requêtes HTTP : GET, POST, PUT et DELETE Principes de REST 2/7 Rest 9
  • 10.
    Ressources (Identifiant) •Identifié parune URI Exemple : http://localhost:8080/libraryrestwebservice/books Méthodes (Verbes) • pour manipuler la ressource • Méthodes HTTP : GET, POST, PUT and DELETE Représentation • donne une vue sur l’état de la ressource • informations transférées entre le client et le serveur Exemples : XML, Text, JSON, … Principes de REST 3/7 Rest 10
  • 11.
    Méthodes •Une ressource quelconquepeut subir quatre opérations de base désignées par CRUD  Create (Créer)  Retrieve (Lire)  Update (mettre à jour)  Delete (Supprimer) •REST s’appuie sur le protocole HTTP pour exprimer les opérations via les méthodes HTTP  Create POST  Retrieve GET  Update PUT  Delete DELETE Principes de REST 4/7 Rest 11
  • 12.
    Méthodes • Méthode GETfournit la représentation de la ressource GET: /produits/tv HTTP status: 200 (OK) ReprésentationClient Serveur • Méthode POST crée une ressource POST: /produits/tv Représentation dans le corps Client HTTP status: 201 (Created) Serveur Principes de REST 5/7 Rest 12
  • 13.
    Méthodes • Méthode DELETEsupprime une ressource DELETE: /produits/tv/2 HTTP status: 200 (OK) Client Serveur • Méthode PUT met à jour une ressource PUT: /produits/tv/2 Représentation dans le corps Client HTTP status: 200 (Ok) Principes de REST 6/7 Serveur Rest 13
  • 14.
    Fournir les donnéessuivant une représentation pour: • le client (GET): format de sortie • le serveur (PUT et POST): format d’entrée La représentation d’une ressource peut prendre différents formats: • XML • JSON • Text •… Le format d’entrée (PUT et POST) et le format de sortie (GET) d’un service Web d’une ressource peuvent être différents Principes de REST 7/7 Représentation Rest 14
  • 15.
    WADL 1/2  WebApplication Description Language  est un langage de description XML de services de type REST  est une spécification W3C initiée par SUN  l’objectif est de pouvoir générer automatiquement les APIs clientes d’accès aux services REST Remarques -Peu d’outils exploite la description WADL -Apparu bien plus tard Rest 15
  • 16.
  • 17.
    Service web étendusVS REST 1/5  Services web REST sont orientés ressource Les mêmes opérations quelque soit la resource Les opérations dépendent des types des activités  Services web étendus sont orientés activité Rest 17
  • 18.
    Protocole de communication MessageSOAP Client Serveur  Services web étendus Service web étendus VS REST 2/5  REST Requête/Réponse HTTP Client Serveur Rest 18
  • 19.
    Service web étendusVS REST 3/5 Services web étendus Services web REST Exposition des opérations Exposition des ressources Protocole de communication SOAP HTTP Protocole de transport HTTP, autres HTTP Description des interfaces WSDL WADL Format des données XML XML, Text, JSON… Rest 19
  • 20.
    Service web étendusVS REST 4/5 Rest 20
  • 21.
    Services Web REST Avantages -Simplicité -Lisibilitépar l’humain -Représentations multiples Inconvénients -Sécurité restreinte Services Web étendus Avantages -Standardisé -Sécurité (WS-Security) -Outillé Inconvénients -Complexité, lourdeur Service web étendus VS REST 5/5 Rest 21
  • 22.
    Services Web RESTavec Java  JAX-RS: Java API for RESTful Web Services  Spécification décrivant la mise en œuvre des services web REST  JAX-RS est basé sur les annotations @Path définit le chemin de la ressource. Cette annotation se place sur la classe et/ou sur la méthode implémentant le service. @GET, @PUT, @POST, @DELETE définit l’action implémentée par le service @Produces spécifie le type de la réponse du service @Consumes spécifie le type accepté en entré du service Rest 22
  • 23.
    Services Web RESTavec Java  Différentes implémentations de JAX-RS sont disponibles: • JERSEY (Oracle) • CXF (Apache) • RESTEasy (JBoss) • RESTlet  Seule l’approche bottom-up est possible • Annoter une classe POJO • Compiler et déployer  JAX-RS se limite à l'implémentation serveur, la spécification ne propose rien d côté client. Rest 23
  • 24.
    En résumé • RESTest un style d’architecture • REST est une alternative aux services web étendus (SOAP) • REST se base sur le protocole HTTP • JAX-RS est l’API java permettant de développer des services web REST Rest 24

Notes de l'éditeur

  • #6 You can only understand it, and design your Web services in that style. (Analogous to the client-server architectural style. There is no client-server standard.) While REST is not a standard, it does use standards: HTTP URL XML/HTML/GIF/JPEG/etc (Resource Representations) text/xml, text/html, image/gif, image/jpeg, etc (MIME Types)
  • #8 REST est « stateless » (il n’est pas adapté aux transactions longues et complexes) : il est parfait pour les opérations simples (créer, lire, mettre à jour, effacer). Aucun lien entre une requête et une autre
  • #18 dispose d’une ressource surlaquelle on peut effectuer plusieurs opérations La ressource est identifié par une URI Les opérations qu’on eut effectuer sont définies par HTTP ------------  A simple example of an activity service would be a bank transaction in which a customer transfers money from one account to another. The customer doesn't want to work with the resources directly (the money, the bank accounts, and so forth), they merely want to tell the bank what it is they want to accomplish and have the bank handle the resources on their behalf. 
  • #20 Think of what a "traditional web service" is. It is an interface with exposed "methods." Clients know the methods' name, input and output and hence can call them. Now imagine an interface that does not expose "methods". Instead, it exposes "objects". So when a client sees this interface, all it sees is one or more "objects". "An object" has no input and output – because "it does not do anything". It is a noun, not a verb. It is "a thing", not "an action".