Architecture des SI - partie 2

Architecture des SI - partie 2 - année 2014
Didier FERMENT - Université de Picardie
REST
"Representational State Transfer" est une architecture orienté ressource suggéré par Roy
T. Fielding (co-auteur d'Apache)
•donc basé sur HTTP, les URIs, les liens ....
•c'est un mécanisme analogue à RPC (Remote Procedure Calls) et les Web
Services (SOAP, WSDL, …) mais beaucoup plus simple.
•Ce n'est pas un "standard W3C".
•Roy T. Fielding a définit des règles à respecter pour une architecture RESTful
•Règle : les ressources sont identifiées par URI
Exemple :
•http://nirvana.com/prophetes identifie la liste des prophètes
•http://nirvana.com/prophetes/13 identifie le 13-ème prophète
•http://nirvana.com/prophetes/brian identifie le prophète brian
•http://nirvana.com/prophetes/13/propheties identifie la liste des prophéties du
13-ème prophète
•Règle : les ressources sont manipulées au travers des représentations
•une ressource peut avoir des représentations dans des formats divers : XML,
CSV,
JSON, HTML, CSV, ....
•Le client peut définir le(les) format de réponse souhaitée via l’entête Accept.
•Exemple :
GET /prophetes/13 HTML/1.1
Host: nirvana.com
Accept: application/xml
•Règle : Utiliser les verbes HTTP comme identifiant des opérations
•HTTP propose les verbes correspondant aux 4 opérations CRUD :
•Créer (create) => POST

•Afficher (read) => GET
•Mettre à jour (update) => PUT
•Supprimer (delete) => DELETE
•Exemple :
•GET http://nirvana.com/prophetes lit la liste des prophètes
•DELETE http://nirvana.com/prophetes/13 supprime le 13-ème prophète
•POST http://nirvana.com/prophetes + body des données pour créer un
prophète
•PUT http://nirvana.com/prophetes/13 + body des données pour modifier le
13-ème prophète
•Règle : Stateless : Pas de gestion d'état
•Le serveur ne stocke jamais l’état des applications donc des requêtes.
•Simplifie le service mais augmente le volume de communication !
•L'alternative est fournie par la règle suivante : HATEOAS
•Règle : Hypermedia as the Engine of Application State (HATEOAS)
•Les liens hypermédia doivent permettre l’enchaînement des actions donc le
changement d'état
•exemple : l'URI de suppression d'un prophète propose, en retour, un lien d'URI
pour en faire un saint.
DELETE /prophetes/13 HTML/1.1
Host: nirvana.com
Accept : application/xml
HTTP/1.1 200 OK
Content-Type :application/xml
<status>stopped as martyr</status>
<link rel="beatification" method="post" href="prophetes/13/beatifier" />
web-ographie :
•http://opikanoba.org/tr/fielding/rest/
chapitre 5 de la thèse de Roy T. Fielding sur REST
•http://rest.elkstein.org/2008/02/what-is-rest.html
présentation simple de REST
•http://mbaron.developpez.com/soa/jaxrs/
Développer des Services Web REST avec Java : JAX-RS de Mickael BARON
•http://docs.oracle.com/javaee/6/tutorial/doc/giepu.html
The Java EE 6 Tutorial : Chapter 20 - Building RESTful Web Services with JAX-RS
•https://jersey.java.net/documentation/latest/index.html
documentation de l'Api Jersey implémentation de JAX-RS

Api Jersey
Api Jersey pour service Restful
•JAX-RS = spécification par le Java Community Process pour les services Restful en
Java
•décrit uniquement le coté serveur
•javax.ws.rs.* = package de JAX-RS
•implémentations : XCF d'Apache, RestEasy de Jboss, ...
•Jersey est l'implémentation d'Oracle pour cette spécification
•fonctionne sur Tomcat, GlassFish, JBoss, ….
•construit avec Apache Maven : ce qui simplifie la dépendance entre APIs
•fournit une Api coté client.
Installation
•requis : Java 7
•Tomcat 7 : http://tomcat.apache.org/
téléchargez puis décompressez
•Eclipse Standard/SDK Version: 4 .3.2 Kepler
http://www.eclipse.org/
•téléchargez puis décompressez puis démarrez
•Installez Web, XML, JavaEE and OSGi Entreprise Development :
Help → install new software
→ work with → Kepler - http://download.eclipse.org/releases/kepler
Cochez -> Web, XML, JavaEE and OSGi Entreprise Development
→ … finissez
•Installez Maven for Eclipse :
Help → install new software
→ Add repository → name : M2Eclipse → location :
http://download.eclipse.org/technology/m2e/releases
Cochez → Maven for Eclipse
→ … finissez
•Maven est un successeur de make d'Unix et d'Ant d'Apache pour gérer le
cycle de vie d'un projet logiciel
•Le fichier de description du projet est pom.xml :project object model. Il
contient des dépendances avec des ressources internes ou externes et les
séquences de compilation, test, installation, …
•Maven est capable de récupérer des ressources via le réseau dans des
dépôts, notamment suite à des dépendances transitives. C'est ce point fort
que nous allons exploiter
•Un projet Maven a sa propre structure arborescente évidemment différente
d'un projet Eclipse. Le plugin assure une assez bonne cohérence des 2.

Premier Service : le classique hello
•View → Open Perspective → Java EE
•File -> New → Maven Project
→ maven-archtype : "Internal Catalog" maven-archtype-webapp
→ groupId : testJersey → artifactId : hello
•Project Explorer → hello
→ src -> add folder --> src/main/java
→ Java ressources -> src/main/java -> New --> Package df.jersey.helloserver
•→ pom.xml : ajoutez les dépendances Jersey nécessaires au projet
<dependency>
<groupId>org.glassfish.jersey.containers</groupId>
<artifactId>jersey-container-servlet</artifactId>
<version>2.8</version>
</dependency>
•→ Java ressources -> src/main/java -> df.jersey.helloserver → new class Hello
•rmq : les sources se trouvent dans src/main/java dans un projet Maven
package df.jersey.helloserver;
import javax.ws.rs.DefaultValue;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.MediaType;
@Path("/bonjour")
public class Hello {
@GET
@Produces(MediaType.TEXT_PLAIN)
public String sayPlainTextHello() {
return "bonjour";
}
@GET
@Produces(MediaType.TEXT_XML)
public String sayXMLHello() {
return "<?xml version=\"1.0\"?>" + "<hello> bonjour" + "</hello>";
}
@GET
@Produces(MediaType.TEXT_HTML)
public String sayHtmlHello() {

return "<html> " + "<title>" + "bonjour" + "</title>"
+ "<body><h1>" + "bonjour" + "</h1></body>" + "</html> ";
}
}
•→ src/main/webapp/WEB-INF → editer web.xml :
•fichier descripteur de déploiement de l'application web : il contient les
caractéristiques de l'application, les servlets utilisées, les paramètres
d'initialisation ….
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<display-name>Hello</display-name>
<servlet>
<servlet-name>Hello</servlet-name>
<servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
<init-param>
<param-name>jersey.config.server.provider.packages</param-name>
<param-value>df.jersey.helloserver</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Hello</servlet-name>
<url-pattern>/rest/*</url-pattern>
</servlet-mapping>
</web-app>
•→ Run on server
→ manually define ... → Apache → tomcat7 → next
→ Tomcat installation directory →chemin/absolu/jusqua/apache-tomcat-7.0.54
•Désormais, vous pourrez ré-utiliser le serveur défini.
•Dans un Navigateur :
http://localhost:8080/hello/rest/bonjour
bonjour
•Voici la capture des échanges HTTP par wireshark :
GET /hello/rest/bonjour HTTP/1.1
Host: localhost:8080
Connection: keep-alive
Cache-Control: max-age=0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 ...
Accept-Encoding: gzip,deflate,sdch
Accept-Language: fr-FR,fr;q=0.8,en-US;q=0.6,en;q=0.4
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: text/html
Content-Length: 66
Date: Sat, 14 Jun 2014 07:45:22 GMT
<html> <title>bonjour</title><body><h1>bonjour</h1></body></html>
•Les éléments du service REST hello :
•Le projet se nomme hello
•donc par défaut c'est la base du chemin de la ressource REST
•La classe Hello du package df.jersey.helloserver est un POJO :
•Plain Old Java Object, sans les lourdeurs d'écriture d'un bean