Web APIs in Action (in French)

WEB APIS IN ACTION
SFEIR – 17 octobre 2012

Copyright Restlet SAS – Tous droits réservés
INTERVENANT
ENTREPRENEUR ET EXPERT EN APIS WEB
Jérôme LOUVEL
– Ingénieur PolyTech’Montpellier
– 12 ans d’expérience dans l’édition logicielle et le
service informatique, dont 3 ans aux USA
– CEO de Restlet et créateur de Restlet Framework
– Expert JAX-RS 1.0 (JSR-311)
– Contributeur à “RESTful Web Services” (O’Reilly)
– Co-auteur de “Restlet in Action” (Manning)
Contact:
– jlouvel@restlet.com
– Twitter : @jlouvel et Google+
– Blog : blog.restlet.com

AGENDA
1. Tour d’horizon des APIs web (10 mn)
2. De REST aux APIs web (5 mn)
3. Introduction à Restlet Framework (5 mn)
4. API Restlet vs API JAX-RS (10 mn)
5. Prochaines étapes du projet (5 mn)
6. APISpark, Restlet as a Service (5 mn)
• Durée totale : 45 mn

TOUR D’HORIZON DES APIS WEB
Partie 1/6

LE WEB AUJOURD’HUI
MOBILE + CROSS-MACHINE
API
Utilisateurs d’Internet : 2,3 milliards
Objets connectés : 10 milliards
Besoin d’échange d’info
Nouvelle génération de sites web
Accessible par toute machine
 Web APIs !
API
TV connectée
Ordinateur
Smartphone
Tablette
Applis sociales
Partenaires

L’API WEB
ÇA SE CONSOMME
• Enrichir un site web
(mashups, flux blog/tweets, Google Maps)
• Import/Export SaaS
(libérer ses données, changer de fournisseur)
• Intégration SaaS
(notifier / web hooks, automatiser / workflow)
• APIs composites
(combiner plusieurs APIs en une autre, SIRI)
6

L’API WEB
ÇA PERMET D’EXPOSER
• Backend Mobile
(connectées, natives ou HTML 5)
• Backend SaaS
(HTML 5/AJAX, API développeur/partenaire)
• Backend Open Data
(multi-formats, API développeur, big data)
• Backend Internet des Objets
(M2M, RFID, géolocalisation)
7

TWITTER ET LES APIS WEB
REST
API
Database
Streaming
API
Search
API
Web SiteiPhone Third-party

TWILIO, L’API WEB EST LE PRODUIT
9

GOOGLE MAPS IMAGE API
10
http://maps.googleapis.com/maps/api/staticmap?
center=Brooklyn+Bridge,New+York,NY&
zoom=14&
size=512x512&
maptype=roadmap&
markers=color:blue%7Clabel:S%7C40.702147,-74.015794&
markers=color:green%7Clabel:G%7C40.711614,-74.012318&
markers=color:red%7Ccolor:red%7Clabel:C%7C40.718217,-
73.998284&
sensor=false
• Représentation « image/png » de la ressource de carte
• Une ressource REST peut exposer des représentations
binaires

AMAZON ET LES APIS WEB
11
• Authentification exotique
• Anti-pattern d’API RESTful
• Mais AWS reste une référence dans le cloud !

NOMBRE D’APIS PUBLIQUES
EN PLEINE CROISSANCE !
Source: ProgrammableWeb
1 million d’APIs en 2017 !

LE PLUS IMPRESSIONNANT EST CACHÉ
L’ICEBERG DES APIS PRIVÉES!

NOMBRE DE SITES WEB
UN PARALLÈLE QUI LAISSE RÊVEUR !
Source: NetCraft / Jacob Nielsen
APIs web
publiques

DE NOUVEAUX ACTEURS
15
• Frameworks RESTful
• Génération de doc
• Frameworks NIO/HTTP
• Backends as a Service
• Applis mobiles
• SaaS & sites riches
• Open data
• Internet des Objets
• Sécurisation
• Analytics
• SDKs clients
• Gestion communauté
• Annuaire
• Monétisation
• Animation
• Référencement
• Oracle Jersey
• JBoss RESTEasy
• XINS, Swagger
• Enunciate
• Restlet Framework
• StackMob
• Parse.com
• Sencha.io
• Firebase
• APISpark
• Apigee
• Mashery
• 3Scale
• WebServius
• APISpark
• ProgrammableWeb
• Mashape
• Alcatel Open API Platform
• The Easy API
• APISpark

DE REST AUX APIS WEB
Partie 2/6

REST AU CŒUR DES APIS WEB
MAIS RAREMENT DU PUR REST…
• REST est souvent synonyme de non-SOAP…
• L’hypermédia est rarement exploité…
• JSON s’imposent de plus en plus souvent
• Exigence de qualité croissante : REST comme guide

« WEAVING THE WEB »
VISION D’ORIGINE ET ÉVOLUTION DE HTTP
HTTP/1.0
HTTP/1.1
REST
HTTP/0.91991
1996 RFC 1945
1999 RFC 2616
2000
HTTP/1.1 bis2013 ? IETF draft
W3C Notes
Dissertation
HTTP/2.0 IETF proposal?
Vision original du Web (source: TBL)
• Internet
• Document
• Hypertexte
• Lecture et écriture

Internet
TCP/IP
HTTP, REST
Web 1.0
(Documents)
Web 2.0
(Social)
Web 3.0
(Semantic)
Cloud
computing
(IaaS, PaaS,
SaaS)
Mobile web
(App natives,
HTML 5)
Web of
things
(Machines)
UN WEB EN CONSTANTE ÉVOLUTION
+ 20 ANS D’INNOVATION

UNE HISTOIRE DE PARADIGMES
LA RÉCONCILIATION?
RPC
Services Web
(SOAP, *-RPC)
REST
résistance
APIs Web
Web des
documents
Web des
machines
convergence
1. Architecture distribuée (TCP)
2. Identification universelle (URI)
3. Interface uniforme (HTTP)
4. Hypermédia (HTML, RDF)
5. Couplage faible C/S
1. Connectivité limitée (mobilité)
2. Nouvelles IHMs (apps, objets)
3. Interactions cross-machine
4. Automatisation (M2M)
5. Couplage moyen C/S
1. Architecture distribuée
2. Automatisation (programmes)
3. Interface
4. Couplage fort C/S

APIS WEB
UNE ÉVOLUTION DE REST
Principes communs
1.Architecture distribuée (TCP)
2.Identification universelle (URI)
3.Interface uniforme (HTTP)
Différences significatives
1.IHMs hétérogènes
• Taille d’écran (cinéma, TV, moniteur, ligne LCD, etc.)
• Modes d’interaction (clavier/souris, télécommande, etc.)
• Connectivité (permanente, intermittente, rare, aucune)
• Automatisation (M2M, agents, capteurs, SaaS 2 SaaS, etc.)
2.Couplage moyen C/S
• JSON, XML, YAML, CSV : formats d’échange de données seulement
• Connaissances préalable côté client plus fortes, besoin de stabilité
REST

INTRODUCTION À RESTLET FRAMEWORK
Partie 3/6

RESTLET FRAMEWORK
PROJET OPEN SOURCE CRÉÉ EN 2005
A N D R O I D G A E G W T J A V A E EJ A V A S E
Langage Java
O S G I
Editions multiples
Génération semi-auto.
Framework pour exposer et consommer
des APIs web de style REST

DE NOMBREUSES RÉFÉRENCES
PLUS DE 50 000 UTILISATEURS

MULTI-PROTOCOLES
MAIS, CENTRÉ SUR HTTP!
Semantics
Messaging
Payload
Conditional
requests
Ranged
requests
Caching Authentication
Restlet
API
Restlet
Engine
Connecteurs:
• HTTP
• AJP
• FTP
• RIAP
• CLAP
• FILE
• POP3
• SMTP
• JDBC
• SIP

MULTI-CLOUD
AUGMENTEZ LA PORTABILITÉ DE VOS APIS ET APPLIS WEB

COMPÉTITION
PLUSIEURS VISIONS DU WEB…
HTTP toolkits
WS-*
frameworks
OO web
frameworks
MVC web
frameworks
RESTful web
frameworks
Wicket, Tapestry
Axis, CXF, XINS
Spring MVC, Play!
Servlet, Apache HTTP Client, Netty, etc.
Restlet, Jersey, RESTeasy

API RESTLET VS API JAX-RS
Partie 4/6

PACKAGES DE L’API RESTLET
UN CŒUR COMPLET MAIS COMPACT
org.restlet.data
org.restlet.representation
org.restlet
org.restlet.resource
org.restlet.routing
org.restlet.security
org.restlet.service
org.restlet.util

UNE API JAVA COMPLÈTE
USAGE EN BIBLIOTHÈQUE OU EN FRAMEWORK

FILTRAGE ET ROUTAGE
MULTI-THREAD ET DYNAMIQUE
Next Restlet
Filter
B
C
A
Router
B
C
A
Route 1
Route 2
Route 3
A
B
C

INTERFACES ANNOTÉES
APPROCHE UNIFORME, CLIENT & SERVEUR
HTTP
Annotated
Java interface
REST API
Client
resource
Server
resource
Client
proxy
Server
subclass

SERVICE DE CONVERSION
EXTENSIBLE, SCORING, BEANS DE REPRÉSENTATION
Resource
XML
HTML
JSON
State
Representation
bean
Form Data
RDF
…
Atom
Converter
service

RESTLET API 1.1 VS JAX-RS 1.0

COMPARAISON APIS JAVA 1/2
Caractéristique API Restlet 2.1 API JAX-RS 2.0
Style d’API Java Centré Ressource
et héritage
Centré POJO et
annotations
Nombre d’annotations 5 24
Entêtes HTTP supportées 50 26
Version minimum Java SE 5.0 Java SE 6.0
Alignement HTTP et REST Complet Partiel
Sécurité Oui Non
Routage (filtres et routeurs) Oui Limité
Composants et connecteurs Oui Non
Fichiers statiques Oui Non

COMPARAISON APIS JAVA 2/2
Caractéristique API Restlet 2.1 API JAX-RS 2.0
Reverse proxy Oui Non
Représentations asynchrones Oui Non
Streaming HTTP Complet Limité
Réponses provisionnelles Oui Non
Standard JCP Non Oui
Ecosystème Ouvert (Google,
AWS, Oracle, IBM,
MS, etc.)
JCP (Oracle, RedHat,
OW2, etc.)
Ancienneté 7 ans 5 ans
Innovation Rapide Lente

DES STYLES DE CODAGE DIFFÉRENTS 1/2
SHOW ME THE CODE!
JAX-RS API 2.0
// Get instance of Client
Client client =
ClientFactory.newClient();
// Get account balance
String bal =
client.target("http://.../atm/{cardI
d}/balance")
.pathParam("cardId", "112233")
.queryParam("pin", "9876")
.request("text/plain").get(String.cl
ass);
Restlet API 2.1
// Get instance of Client
ClientResource client = new
ClientResource(""http://.../atm/{cardId}
/balance");
// Get account balance
client.setPathValue("cardId", "112233");
client.setQueryValue("pin", "9876");
client.accept(MediaType.TXT_PLAIN);
String bal = client.get(String.class);

DES STYLES DE CODAGE DIFFÉRENTS 2/2
SHOW ME THE CODE!
JAX-RS API 2.0
@POST
@Path(“withdrawal")
@Consumes("text/plain")
@Produces("application/json")
public Money withdraw(
@PathParam("card") String card,
@QueryParam("pin") String pin,
String amount){
return getMoney(card,
pin, amount);
}
Restlet API 2.1
@Post(“txt:json”)
public Money withdraw(){
String card = getPathValue(“card”);
String pin = getQueryValue(“pin”);
String amount = getQueryValue(“amount”);
return getMoney(card, pin, amount);
}

PLUS QU’UNE API JAVA
C’EST LE FRAMEWORK QUI COMPTE!

PROCHAINES ÉTAPES DU PROJET
Partie 5/6

RESTLET FRAMEWORK 2.1 (1/2)
2 ANS DE DÉVELOPPEMENTS !
• Améliorations incrémentales de l’API Restlet
– Pas mal de sucre syntaxique (getQuery, getPath, etc.)
– Amélioration annotations. Example: @Get("form|xml:json?level=2")
– Traçage des requêtes individuel facilité
– ConnegService, DecoderService côté client
– Gestion côté client de l’absence de chunk encoding dans GAE
– Extension EMF (converter XMI/XML), HTML (multi-part upload)
• Sécurité des APIs web renforcée
– Support des schémas AWS S3, AWS Query, Cookie et GAE
– Support de Google Secure Data Connector (SDC) hors GAE
– Nouvelles extensions OAuth 2.0 et OpenID 2.0 (draft specs)
• Nouveau connecteur HTTP interne
– Design NIO non-bloquant, peu de threads
– Zéro dépendance, centré HTTP/Restlet, lecture représ. asynchrone
– Dépréciation des extensions Grizzly et Netty
– Documenté et extensible (extension SIP)

RESTLET FRAMEWORK 2.1 (2/2)
SORTIE EN SEPTEMBRE 2012
• Livre « Restlet in Action »
– Version papier synchro avec la version 2.1.0
• Option « Apache Public License 2.0 »
– En plus d’EPL 1.0, LGPL 2.1/3.0 et CDDL 1.0
– Licences commerciales possible si nécessaire
• Migration vers GitHub
– Historique SVN avec branches importé
– Tickets Tigris.org importés
– Forge Restlet automatisée mise à jour
– Augmentation des contributions constatée !
• Migration vers StackOverFlow
– Déjà largement utilisé pour les questions simples et bogues
– Augmenter la qualité des échanges dans le groupe sur Google en retour

RESTLET FRAMEWORK 2.2
CYCLE COURT (1 AN)
• Nouveau site web
– Basé sur Twitter Bootstrap et GitHub Pages
– Migration du wiki de Daisy vers Javadocs et GitHub Wiki
– Nouveau tutoriel
• Migration vers Google Groups
– Listes de diffusion utilisateurs et développeurs encore sur Tigris.org
• Migration vers Java SE 6
– Java SE 5 supporté depuis Restlet Framework 1.0 !
– Réduire la taille du code (ex: service pattern)
• Améliorations incrémentales
– Optimiser la taille des éditions Android et GWT
– CacheService : générique et extensible
– OAuth 2.0 : support de la spec. finale

APISPARK, RESTLET AS A SERVICE
Partie 6/6

FONCTIONNALITÉS 1/2
La plate-forme tout-en-un pour APIs web
• Créer votre API web rapidement
– En 5 minutes à partir d’un modèle existant (API blog)
– En quelques heures à partir de rien ou par personnalisation d’un modèle
existant (annuaire d’APIs web disponible)
– Pas de verrou grâce à une fondation open source (Restlet Framework) et un
export du code de votre API web possible
• Hébergement intégré
– Backend scalable et réactif (faible latence, gestion intégrée)
– Disponibilité permanente 24/24h et 7/7j (pas de fenêtre de maintenance) et
sécurisé (confidentialité par SSL, gestion précise des autorisations)
• Versions automatiques
– Gérez plusieurs versions de la même API web en parallèle, sans aucun surcoût
– Pas de risque d’aliéner vos utilisateurs actuels tout en vous laissant libre de
faire évoluer votre API web
– Cycle de vie clair (états: brouillon, publié, déprécié, archivé, supprimé)

La plate-forme tout-en-un pour APIs web
• Documentation automatisée
– Toujours à jour grâce à une saisie optimisée
– Accès web avec tests en live intégré
– Export en PDF et HTML facile
• Génération de kits clients
– Facilitez l’utilisation de votre API par différents types d’utilisateurs
– Support des plate-formes les plus populaires (iPhone/iPad, Android, Java,
.NET, PHP, Python)
• Gestion de la communauté
– Gestion des utilisateurs et de leur demande d’adhésion intégrée
– Communautés publiques ou privées
– Envoi de messages d’annonces publics ou de messages privés
– Intégration avec les réseaux sociaux
FONCTIONNALITÉS 2/2

CONSOLE APISPARK
CATALOGUE D’APIS & DATA STORES

CONSOLE APISPARK
TABLEAU DE BORD

CONSOLE APISPARK
CONCEPTION D’API

CONSOLE APISPARK
ANALYSE D’APIS

• Beta privée: en cours depuis mai 2012
• Beta publique: novembre 2012
• Version 1.0: mai 2013
• Inscrivez-vous !
http://apispark.com
ROADMAP
MERCI !

Web APIs in Action (in French)

Recomendados

Recomendados

Más contenido relacionado

Destacado

Destacado (11)

Similar a Web APIs in Action (in French)

Similar a Web APIs in Action (in French) (20)

Más de Restlet

Más de Restlet (20)

Web APIs in Action (in French)