Mashup sémantique

Chapitre 4 Les services web REST sémantique

64

<scheme name> : <hierarchical part> [ ? <query> ] [ # <fragment>]

Scheme name fait référence au protocole utilisé pour interpréter les URL (dans ce cas, HTTP), tandis que la partie hiérarchique contient la plupart des informations essentielles pour identifier ce qui est demandé.

Hierarchical part est composé en deux expressions : authority et path.

La partie authority stocke les informations liées à l'hôte: nom d'utilisateur et mot de passe de celui qui tente d'accéder à l'hôte, le port utilisé et l'adresse de l'hôte (utilisé pour le routage de la requête). Autority a la syntaxe suivante:

[ userinfo "@" ] host [ ":" port ]

La partie path (chemin d'accès) contient les informations nécessaires pour localiser la ressource à récupérer dans l'hôte. Un exemple de nom de schéma et la partie hiérarchique:

http://johndoe:[e-mail]:8080/people/

Les parties query et fragment sont facultatives et ne doivent pas être utilisés pour identifier les ressources. Toutefois, ils peuvent être utilisés pour filtrer la représentation récupérés. Un exemple d'URL complet :

http://www.domain.com:8080/people/?name=John#section2

L'identification des ressources est effectuée de la même manière que celles des objets de paradigme orienté objet. C'est, en divisant la réalité des concepts qui sont importants pour le système et qui vont encapsuler les données nécessaires et les états de l'application.

REST oblige l'auteur de définir les URL qui décrivent mieux la ressource qu'il est entrain de créer. Il est très important de choisir des noms représentatifs. Bien qu'il n'existe aucune restriction particulière à la façon dont les URL peuvent être construites.

Des exemples de ressources et de leurs identifiants :

- Une liste de personnes: http://www.domain.com/persons/ - La quantité des voitures sport rouges:

http://www.domain.com/vehicle/red/sports/car/qty/ http://www.domain.com/vehicle/car/sports/red/qty/

- Le commentaire le plus regardé:

Chapitre 4 Les services web REST sémantique

65

http://www.domain.com/comments/mostviewed

Enfin, il est important de lister les autres ressources qui sont en relation avec celle en cours de

conception. Pour chaque relation, il est nécessaire de connaître:

? Son nom et son URI

? La signification de cette relation.

? Définir si elle est une relation plusieurs à plusieurs ou un à plusieurs.

Cette liste aide lors des représentations des ressources et des actions qui peuvent être effectuées dans la ressource, il est également nécessaire de fournir cette liste de liens dans la documentation des ressources.

Définition de représentation :

Une ressource est un mapping conceptuel d'un ensemble d'entités. Ces entités sont ses représentations. Une représentation est une séquence d'octets qui contient des données et des métadonnées pour décrire ces données. Lorsque on utilise REST, le format de données des représentations est le type média ou MIME

MIME est un ensemble de conventions créées pour permettre l'échange des fichiers via Internet tout en gardant le processus transparent pour l'utilisateur.

Lors d'une demande de ressources de la part du client , le serveur démarre un processus de négociation de contenu. Le client envoie une liste des types MIME qui l'accepte, alors que le serveur choisit la représentation qui correspond le mieux aux exigences du client. Cette liste est envoyée dans la requête HTTP dans l?en-tête.

Par conséquent, une fois qu'une ressource a été identifié, il est nécessaire de définir sa représentation. Par exemple, une ressource qui représente une personne pourrait avoir plusieurs représentations: une image JPEG qui stocke une photo de son visage, un document XML qui stocke des informations du contact, une vCard, et ainsi de suite.

Description des méthodes :

Les ressources sont manipulés par le transfert des représentations à travers une interface uniforme adressée par l'identifiant de ressource.

Chaque représentation doit mettre en oeuvre une interface CRUD pour réaliser l'interface uniforme requis par l'architecture REST. Le protocole HTTP/1.1 définit huit méthodes , dont quatre permettent de définir l'interface tels: GET, PUT, POST et DELETE. Le tableau montre la correspondance entre les méthodes HTTP et actions CRUD.

Method	CRUD	Description
POST	Create	Crée une nouvelle ressource
GET	Retrieve	Recupère une representation