REST JUG Toulouse 20100615

REST(ful) Services Web & Architecture Nicolas Zozol

Programme
Présentation
Définition
1er exemple
Intérêt
Services Web
Resource
Jax – Rs
Soap
RPC
Architecture
Restlet
Cloud
Sécurité
Transactions

Définition : Bonnes Pratiques
REpresentational State Transfer
HTTP
Bonnes Pratiques
Tout est Res(s)ource
CRUD : Post, Get, Put, Delete
Stateless
Connectivité : < a href > => GET

HTTP
VERBE + URI
PUT http://exemple.com/myApp/myResource
Header
ContentType : « application/xml; UTF-8»
Authorization : Basic jhekalKslsal=
RequestBody
<firstname>Bob</firstname>

Requête DELETE

Réponse DELETE

Tout est Ressource … et URI

Resource 1..* Representation
<user>
<id>12</id><username> johndoe</username>
</user>
{user : {id:12, username: "johndoe" }}
ContentType : application/xml, application/json, image/png Ou definir la representation : extjs/user

Décrire une URI
URI = U niform R esource I dentifier
On accède à une Resource par son URI
On doit décoder cette URI
Outil inclut : /school/teacher/{username}
Algorithme : GET /tarot/chien?atouts=6&excuse=true
Une liste de Resource est une Resource
/school/teachers/
Une Resource peut avoir plusieurs URI
gwt.code.google.com/docs/2.1
gwt.code.google.com/docs/latests

Intérêts Immédiats
Java connaît HTTP
Compatibilité : Embarqué => Cloud
HTTP 1.1 est un protocole stable
Une URI se copie/colle
Une URI est indexée par Google
HTTP est gratuit
Champion de la montée en charge

Intérêts Immédiats
F U N

Web Services Vendre un accès à des données

Servlet classique

Appel Ajax : POST /rest/user
new Ajax.Request( "/rest/user" , {
method: "POST" ,
requestHeaders:{
"Authorization" : "BASIC FlorentjuG2=" },
postBody: "<username>Gaël</username>"
onSuccess: function (response) {
alert(response.responseText);
},
onException : function (response, ex){
alert(response.responseText);
}
});
Ajout de l’utilisateur Gaël par Florent

Servlet classique < servlet > < servlet-name > PlainOldServlet </ servlet-name > < servlet-class > org.jug.toulouse.server.servlet.PlainOldServlet </ servlet-class > </ servlet > < servlet-mapping > < servlet-name > PlainOldServlet </ servlet-name > < url-pattern > / user </ url-pattern > </ servlet-mapping > Web.xml PlainOldServlet.java @Override protected void doPost (HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String requestBody = FileUtilities.readInputStream( request.getInputStream() ); String username = new VsxJdom().getValue(requestBody, "username" ); User u = new UserCrud().create(username); //Business Code out.write( "<root><id>" +u.getId()+ "</id></root>" ); }

Servlet JAX-RS < servlet > < servlet-name > Jersey </ servlet-name > < servlet-class > com.sun.jersey.spi.container.servlet.ServletContainer </ servlet-class > </ servlet > < servlet-mapping > < servlet-name > Jersey </ servlet-name > < url-pattern > /rest/* </ url-pattern > </ servlet-mapping > Web.xml UserController.java : renvoit l’id du user
@Path( " / user " )
Class UserController extends JaxRsResourceController {
@POST // For POST /myApp/rest/user
@Produces ( "application/xml" )
protected Response addUSer ( String requestBody ) {
String username = new VsxJdom().getValue(requestBody, "username" );
User u = new UserCrud().create(username); //Business Code
return getResponse( "<root><id>" +u.getId()+ "</id></root>" );
}
}

Requête Client Web

Travail Serveur (JEE 5&6)

Wsdl & Xsd

REST vs SOAP
HTTP
Interopérable
Verbe + URI
Sécurité :
SSL+(Autorization/Cookie)
Requêtes lisibles
Génération automatique du code Client possible (Rails, Play!)
Refactorisation simple, à la main
HTTP ; Open Standard, W3C
Intégré au « Produit »
POST + Méthode dans XML
Sécurité en « 1 clic » (WS-Security)
Requêtes complexes
Prévu pour la génération automatique du code Client
Refactorisation facile… ou horrible

Service RPC avec GWT

Service RPC avec GWT
Debug
Interopérabilité

Service REST avec GWT
Projet GWT-REST
Restlet
Robusta Web Library

Robusta Web Library avec GWT RestClientGwt client = new RestClientGwt(); CallbackBasic callback = new CallbackBasic(){ @Override public void onSuccess(AsynchronousRestClient client, String response) { try { userId = new VsxGwt().getNumber(response, "idUser" ); } catch (XmlException e) { onFailure(client, response); }}}; client. setNextRequestBody ( VsxBuilder. buildVerySimpleXml ( "username" , "joedoe" )); client. executePost ( "/myApp/users" ,null, callback);

Quels critères ?

Architecture REST SOA, ROA …

Jeu Statefull

Jeu Stateless

Avec Session

Sans Session

Restfull = StateLess
Ou plus exactement :
L’état est contenu dans le Client
= La suite d’événement est (éventuellement) gérée par le navigateur
« La session, c’est mal »
Pourquoi ?

Cloud  Stateless

Connectivité
Client lourd :
1 point d’entrée : main (String [] args)
Application Web :
X points d’entrée : URI

Connectivité  Stateless

google.com <=> google.com/ig
/google.com/
/google.com/ig

Architecture multiComposants

Interface Uniforme
Quelque soit l’implémentation :
GET /mail
POST /mail
<content>…</content>
DELETE /mail/contacts/johndoe
UPDATE /mail/contacts
<user id= " johndoe " >j.doe@gmail.com</user>

Restlet
Simple executable
1 ligne Java
new Server(Protocol.HTTP, 8182,Part03. class ).start();
10 serveurs = 10 lignes

Restlet

Urbanisation

Urbanisation
Mise à jour du Système d’Information sur plusieurs années, permettant des évolutions
Wikipédia : « L'urbanisme définit des règles ainsi qu'un cadre cohérent, stable et modulaire »

Urbanisation

WADL
< resources base="http://api.search.yahoo.com/NewsSearchService/V1/"> < resource path="newsSearch"> < method name=" GET " id=" search "> <request> < param name="appid" type="xsd:string" style="query" required="true"/> <param name="query" type="xsd:string" style="query" required="true"/> <param name="type" style="query" default="all"> <option value="all"/> (…)

Sécurité & Transaction

BASIC Authentication
HTTPS 1.1
POST /mi5/login
Authorization : BASIC Base64("oss117:howisyourblanquette")
<root> It's good </root>

Problème : le Pop-Up  De nombreuses solutions gèrent BASIC

La boite Login var username=$F("username"), password=$F("password"); var credential = robusta.Codec.encodeB64( username +":"+robusta.Codec. md5 ( password ) ); var authorizationValue = " BASIC " + credential; new Ajax.Request("/mywebapp//login", { method: 'POST', requestHeaders:$H({ Authorization :authorizationValue}), onSuccess: function(transport) { ...} });

Transactions
Pluisieurs écrans
Pas de session
Le client garde :
L’autorisation
L’id de transaction (si possible)

Transactions

Transactions
Le client peut conserver l’ensemble des données necessaires :
Autorisation
idTransaction
idAccounts Jo & Jack
Valeur de transfert
Le client garde des données !

Référence

REST JUG Toulouse 20100615

by JUG Toulouse

Accessibility

Categories

Upload Details

Usage Rights

Statistics