Web Style Architecture - Developer Forum 2012

Web Style ArchitectureComment construire son API avec les principes du web ? (Web Stateless) by Xavier Carpentier @xcapetir http://www.greenivory.com

Les entités ne doivent pas être multipliées par delà ce qui est nécessaire. Guillaume dOckham - Philosophe

WWW‣ WWW, un succés !‣ WWW, des principes !‣ WWW, un modéle !‣ WWW et le REST ! World Wide Web map

Le Speaker‣ Java & Web development addict !‣ Développeur chez GreenIvory‣ @xcapetir sur Twitter‣ Co-organisateur ElsassJUG‣ Mission de conception de lAPI GreenIvory ( je ne suis pas seul ;-) )‣ Participant au DEVOXX France 2012 ! http://www.grainedekawa.com

Agenda‣ Intro : Hyperﬂexibilité ?‣ Contexte WEB‣ WOA, ROA ou REST ?‣ DEMO‣ Questions ?

API = Architectures

Hyperﬂexibilité

Simplicité, Simplicité, Simplicité, Simplicité, Simplicité, Simplicité...

WWW Id like you to put your documents on‣ Inventé par Tim Bernes Lee the Web‣ Agé de + 20 ans et toujours aussi performant ;-)‣ Frustration !

WWW : LinkedData Id like you to put your DATAs on the Web‣ Autre frustration : il n’y a pas de DATAs‣ LinkedData

LinkedData RAW DATA NOW T. B. Lee

World Wide Web ? ‣ Liens ‣ URI ‣ Documents ‣ HTML ‣ Protocoles ‣ HTTP

World Wide Web ~ URI ‣ Unified Resource Identifier ‣ Adresse d’un document ‣ Identifiant unique ‣ Relations entre documents ๏ Un document peut contenir plusieurs liens de documents

World Wide Web ~ Documents ‣ Représentation ‣ HTML (afﬁchages) ‣ XML, JSON (data) ‣ etc. XML : communications entre serveurs JSON : communications avec les browsers

World Wide Web ~ Protocoles (HTTP, ...) ‣ La couche de transport ‣ Verbes : GET, POST, ... ‣ Codes de retours : 200, 500, 404, ... ‣ Header : méta-informations

Codes de retours de HTTP Informations { Succès { } Erreurs du client Redirection {Erreur du client { } Erreurs du serveur

WOA, ROA ou REST ?

Web Style Architecture‣ WOA = Web Oriented Architecture ‣ SOA = Service Oriented Architecture‣ ROA = Resources Oriented Architecture = REST

SOA ?‣ SOA = Service Oriented Architecture‣ Style d’architecture en services à ﬁne granularité‣ http://www.youtube.com/watch?v=sbd_1G8Kqjs

SOA ? ‣ SOA => SOAP ‣ SOAP = protocole pour faire du SOA ‣ SOAP = WSDL, WS-* ‣ Assemblage de brique (Lego) ‣ N’utilise qu’un sous-ensemble du WEB

Architecture - Modèle de développement depuis 1970 Echelle Fonctionnalités Sous-systèmes Système Système de système 70s Modèle structurés opère Code Données 80s Modèle Objet Stateful Code Données Distribué Stateless 90s Modèle Service Service Données2000s Modèle Web2010s Ressources Code

REST !

REST !...c’est un message aux personnes qui s’appêtent à quitter la salle ;-)

REST ? ‣ REpresentational State Transfert ‣ Auteur Roy Fielding en 2000 ‣ L’architecture Web est sufﬁsante ! ๏ Un retour au source : le WEB ๏ La renaissance de HTTP !

REST, c’est ...‣ Architecture qui s’inspire du WEB‣ Style d’architecture‣ Simpliﬁcation‣ Une alternative aux architectures complexes (ex: J2EE)‣ Une philosopie qui supprime l’hyperﬂexibilité et la lourdeur

REST, ce n’est pas... ‣ Un protocole ‣ Une surcouche du Web

REST Modéle vide Client-Server Sans état (Stateless) Cache Interface Uniforme HTTP ...

REST - Déﬁnition Une architecture client/serveur en couches avec interface uniforme, cache et sans état.

Eléments de REST

Principes de REST ‣ Adressabilité ‣ Un ensemble ﬁni d’opération : POST, GET, PUT, DELETE (CRUD) ‣ Orienté représentation : content type ‣ Communication sans état

Principes de REST HATEOAS Hypermedia As The Engine Of Application State

REST pratique !

Méthodes CRUDGET Pour retrouver une information, peut être mis en cachePUT Mettre à jour ou créer avec un ID connuPOST Créer des ressources ou appender des sous ressourcesDELETE Suppression (logique) d’une ressource nb. il existe d’autres verbes pouvant être utilisés HEAD, OPTIONS, etc.

Exemple - GET Exemple d’une API de gestion de contacts ‣ GET /contacts/ ๏ Retourne tous les contacts ‣ GET /contacts/1234 ๏ Retourne le contact ayant 1234 comme identiﬁant

Exemple - POST ‣ POST /contacts/ ๏ Créé un contact ๏ Les données sont envoyées dans le corps de la requête

Exemple - PUT ‣ PUT /contacts/1234 ๏ Mise à jour du contact ๏ Les données sont envoyées dans le corps de la requête

Exemple - DELETE ‣ DELETE /contacts/1234 ๏ Suppression du contact 1234 ‣ DELETE /contacts/ ๏ Suppression de tous les contacts

Exemple de requête/réponse> POST /contacts/ HTTP/1.1> User-Agent: curl/7.19.7 (universal-apple-darwin10.0) libcurl/7.19.7 OpenSSL/0.9.8r zlib/1.2.3> Host: localhost:8080> Accept: */*> Content-Length: 61> Content-Type: application/x-www-form-urlencoded< HTTP/1.1 201 Created< Server: Apache-Coyote/1.1< Content-Type: application/xml< Content-Length: 184< Date: Thu, 24 May 2012 10:11:34 GMT<?xml version="1.0" encoding="UTF-8" standalone="yes"?><contact> <email>mail@xavier-carpentier.fr</email> <ﬁrstName>Xavier</ﬁrstName> <id>0</id> <lastName>Carpentier</lastName></contact>

il REST les outils !

REST - outils Peu d’ou tils sont nécessai res ou‣ Développement disponib les puisq REST es ue t un ens ๏ Eclipse, Netbeans,Visual Studio (C/C++), etc. de pratiq emble ues...‣ Edition ๏ Eclipse, Notepad++, XMLSpy, etc.‣ Test ๏ RestClient, curl, navigateurs web

REST - Frameworks (Java)‣ JSR311 ๏ JAX-RS, API Java de support aux développements de services Web RESTful‣ Jersey ๏ Implémentation de référence JAX-RS / JSR311‣ Restlets ๏ JAX-RS, connectors (HTTP, Client, SMTP, ...) Sécurité SSL, OAuth, etc.‣ valeur RESTEasy grande e s un par rapp ort Pa ๏ Implémention JAX-RS de JBoss ajo utée T pur... au RES‣ Play Framework! ๏ Framework Web REST en Java et Scala, fullstack, ultra DX (Developer eXperience)

REST - Frameworks (Python/Ruby)‣ Ruby on Rails ๏ Framework Web en Ruby pour la création de services RESTful (MVC)‣ Ruby Waves ๏ Framework Ruby MVC d’exposition de Services Web REST‣ TurboGears ๏ Framework Applications Web (Python). Exposition base de donnée avec un contrôleur REST‣ Django REST ๏ Interface générique REST pour le modèle de données du framework Django (Python)

Pour ou REST contre ?

Contre :-(

Contre :-(‣ REST ne déﬁnit aucun élément de sécurité‣REST implique un important changement de paradigme‣REST implique de penser différement, penser ressources

Pour :-)

Pour :-)‣Simplification ๏ Hypertext est un standard‣Simplification ๏ L’identification est un standard (URI)‣Simplification ๏ La couche transport est un standard (HTTP)‣Simplification ๏ Les formats de données sont standard

Sources & Livres‣ Thèse de Roy Fielding ๏ http://www.ics.uci.edu/~ﬁelding/pubs/dissertation/rest_arch_style.htm (en) ๏ http://opikanoba.org/tr/ﬁelding/rest/ (fr)

Merci !GreenIvory Europe Xavier Carpentierhttp://www.greenivory.fr @xcapetirinfo@greenivory.fr x.carpentier@greenivory.com+33 (0)9 50 53 10 34GreenIvory Americahttp://www.greenivory.cominfo@greenivory.com+1 (919) 901-0693

http://blog.greenivory.fr	553
http://xavier-carpentier.fr	425
http://ranksit.com	3

Web Style Architecture - Developer Forum 2012

by Xavier Carpentier on Jun 07, 2012

Accessibility

Categories

Upload Details

Usage Rights

3 Embeds 981

Statistics

Web Style Architecture - Developer Forum 2012 Presentation Transcript