4 réponses à ce sujet Vous ne pouvez pas répondre à ce sujet

[goldbergg]

Bonjour voici une petite documentation concernant les Webservice et REST, il ne s'agit pas d'un tutoriel mais d'une explication sur le concepte, un tuto sur la création de webservice suivra probalement.


Un Webservice est comme son nom d'indique un service proposé sur le Web. Il ne retourne pas de page web mais des information sous forme strucuré (XML, JSON, etc...) qui pouront par la suite être utilisé sur une page web ou une application.
exemple: Un site de méteo proposera un webservice qui retourenera la méteo sous forme XML, le service prendra en paramétre le nom de la ville désiré.

REST est une architecture qui proppose certain standars afin de créer des WebService:

-ChaqueWebService est représenté par UNE URI et représente donc une ressource

-Une ressource peut représenter plusieurs actions (Ajout, Suppression, Modification,etc....)

-L'URI doit être indépendant du langage utilisé ainsi n'est pas valide mais l'est.

-Les ressources utilisent les méthodes HTTP pour définir les actions.

-Chaque webservice a une spécification qui définit son mode d'utilisation.

Définition:

REST :Representation State transfer, il ne s’agit pas d’un protocole mais d’une façon de coder (architecture)

URL : Uniform Ressource Locator

URI : Uniform Ressource Identifier


La différence entre URL et URI est minime etant donnée qu'une URL est une URI(mais pas forcement l'inversse).

Pour les WebService on parlera principalement d'URI qui désignera une ressource (qui correspond a se que propose le service), ainssi une URI sera la même pour tout utilisation d'un service (se qui changera sa sera la méthode HTTP utilisé) contrairement a une URL qui changerai a chaque action.

JSON: JavaScriptObject Notation, c’est un format de donnée comparable à XML ou encore au fameux x-www-form-urlencoded.Il n’est pas obligatoire mais permet de faire circulé plus facilement les données.

Les avantages (d'un webservice selon REST):

-Simple à mettre en place (pas besoinde plugin ni de module contrairement à SOAP par exemple)

-Aucune obligation concernant le langage utilisé

-Un webservice peut être aussi bien utilisé pour une application web que pour une application mobile ou Smartphone

Exemple simple de fonctionnement:

Spoiler

Voici un exemple d'un webservice permettant la gestion des utilisateurs sur un site.

Ces spécifications sont:

-Ajouter un utilisateur, prend en paramètre un tableau associatif (Nom, Prenom, Pseudo, Password) encodé auformat JSON, retourne l'ID utilisateur si l'ajout a réussi et rien si il a échoué

-Modifie un utilisateur, prend en paramètre un tableau associatif (ID,Nom, Prenom, Pseudo, Password) encodé auformat JSON, et retourne un booléen

-Supprime un utilisateur, prend un ID en paramètre et retourne un booléen

-Affiche un utilisateur, prend un ID en paramètre et retourne un tableau associatif (Nom, Prenom, Pseudo,Password) encodé au format JSON



Voilà on a donc 4 possibilités correspondant à 4 méthodes HTTP à savoir dans l'ordre POST, PUT, DELETE et GET.
(un Webservice ne propose pas forcément 4 possibilité)

(Pour rappel les méthodes http sont : GET, HEAD, POST, OPTIONS, CONNECT, TRACE,PUT, DELETE)

L'URIde se Webservice est (URI fictive inventé pour l'exemple)


Maintenant voyons l'utilisation.

En Javascript via l’Ajax(avec le framework Jquerry)

[*]//Affiché un utilisateur
[*]var utilisateur = $.ajax( {type : "GET" , url: "",data:”{ID : 3}” , async:false }).responseText;
[/list]On a bien la méthode (GET), l’URI et les paramètres « {ID : 3} » la variable utilisateur sera un tableau JSON contenant les information de l'utilisateur ayant l'ID 3

[*]//Ajouter un utilisateur
[*]if ($.ajax({type : "POST" , url: "" ,data:”{ Nom:Jean, Prenom : Paul , Pseudo : Toto , Password : 123456789 }” , async: false }).responseText) alert("Utilisateur ajouté");
[/list]On retrouve toujour la même URI, la méthode a changé ainssi que les paramétre.


Exemple d'utilisation en PHP :


[*] //On défini la méthode et le type de donné a envoyé
[*] $opts = array('http'=>array( 'method'=>'PUT' , 'header'=>'Content-type:application/Json'));
[*] $context = stream_context_create($opts);
[*] //On créé les donnée a envoyer
[*] $opts['http']['content'] =json_encode(array(ID =>'32’, Nom => ‘Jean', Prenom =>’ Paul’, Pseudo =>’Totot’, Password =>'987654321'));
[*] //On fait appel au WebService
[*] $test =file_get_contents('' False, $context);
[/list]
Et un dernier exemple en Java (Android):



[*] //On défini l'URI
[*] String PostURL = "
[*] //On créé la connexion avec la méthode POST
[*] HttpPost httppost = new HttpPost(PostURL);
[*] //On prépare les paramétre a être envoyé
[*] httppost.setEntity(new UrlEncodedFormEntity(MonTableauAuFormatJSON));
[*] //on instencie un client HTTP
[*] DefaultHttpClienthttpclient = new DefaultHttpClient();
[*] //On fait appel au WebService
[*] HttpResponse response=httpclient.execute(httppost);
[*] //On traite les donné du flux envoyé par le webservice
[*] BufferedReader reader = new BufferedReader(newInputStreamReader(response.getEntity().getContent()));
[*] //on récupére le résultat dans une variable
[*] String reponse = reader.readLine();
[/list]
(je n’ai pas mie la gestion des exception)

Bref selon le langage l’utilisation est plus ou moins simple mais pas si compliqué que sa (en C# c’est encore plus simple que dans les exemples^^).

Ces trois exemple permette de démontré une chose, les webservice ne sont pas spécifique à un langage ni à une plateforme, on peut les utilisé coté serveur (PHP, ASP, etc…), coté client(JavaScript) et dans des applications autre que le Web (JAVA, C#, VB, C, C++,W-language, etc…).

Ainsi en codant un site uniquement via des WebService, la partie cliente devient indépendante de la partie serveur, si l’on décide de passé de PHP à ASP par exemple, seul les WebService seront à modifier (Les URI et les spécification devrontt réster les mêmes), de même que l’on pourrait aisément modifier la partie cliente sans toucher à la partie serveur(webservice). L'on pourait même imaginé plusieur site utilisant les même WebService mais avec des interface diférente.

Pour les intéréssé google propose des API php REST permettant de pouvoir codé sa propre interface client pour ces nombreux service (calendar, map, youtube, etc…).

Enfin les webservice permette facilement et rapidement de passé une application web sur une autre Platform tel qu’une application bureau ou encore Smartphone.


Voila j'éspére avoire été assé claire, n'ésité pas a poser des question, si vous êtes intéréssé je peut faire un Tuto sur la création de WebService en PHP.

[Ptiguesh]

Hou ! Que de mots compliqués (enfin bon, avec mon intelligence...) Sinon, bon tuto (plutôt explication) ! Parfait pour les membres avides d'informatique !

Modifié par Ptiguesh, 27 novembre 2011 - 23:52.

[Mouquette]

la partie cliente devient indépendante de la partie serveur

Je trouve que cette phrase est la plus intéressante, car, à mon sens, plus il y a d'indépendance dans un code, mieux c'est.Par contre,les valeurs sont bien stocké en BDD ?et sinon, je ne vois pas très bien ce qu'est une URIdans l'exemple avec l'AJAX, " n'étant pas une URL, vers quoi pointe cette adresse ?Comment interpréter l'URI ? qu'est ce qu'il y a derrière ?

[goldbergg]

les valeurs sont bien stocké en BDD ?

La tous dépendera de se que fais le webservice, dans l'exemple avec l'utilisateur, il poura soit être stocké dans une BDD ou dans un fichier en XML voire en JSON

et sinon, je ne vois pas très bien ce qu'est une URI
dans l'exemple avec l'AJAX, " n'étant pas une URL, vers quoi pointe cette adresse ?
Comment interpréter l'URI ? qu'est ce qu'il y a derrière ?

Comme je l'ai dit une URL est une URI, une URL par defaut utilise la méthode GET(sans que l'on est a le spécifié) et permet donc d'affiché la page vers laquelle elle pointe

Avec l'utilisation de webservice on ne va plus parler de page mais de ressources, au lieu d'avoire une possibilité on en a plusieur il est donc plus convenable de parlé d'URI affin de bien spécifié de l'onparle de ressources (au pluriel) et non d'une seul.



voici un exemple d'URI (je n'est pas pris le temp de faire d'URL Rewriting).

l'URI est utilisé dans cette page en ajax:

cette page permet de tester les diférente méthode, de démontré aussi que l'on peut créé ces propre méthode (pas recomandé) avec leur propre variable global et enfin que certaine méthode ne sont pas utilisable comme bon nous semble (HEAD et TRACE)



On peut voire qu'en fonction de la méthode utilisé le resultat change.

" pointera donc (via URL Rewriting) vers un fichier qui aura une strucure similaire:

[*] [*] $method= $_SERVER['REQUEST_METHOD'];
[*] switch ($method) {
[*] case 'PUT':
[*] //mon Code ici
[*] break;
[*] case 'POST':
[*] //mon Code ici
[*] break;
[*] case 'GET':
[*] //mon Code ici
[*] break;
[*] case 'DELETE':
[*] //mon Code ici
[*] break;
[*] default:
[*] echofalse;
[*] break;
[*] }
[*]?>
[/list]et qui en fonction de la méthode fera une action diférente.

[NoRePlay]

Intéressant tout sa, mais faudrait que je développe quelque chose de ce type la mais avec différente commande MYSQL, je ferai le test quand je travaillerai sur un site WEB