WebDev 21 : Les web services

Créer un service REST simple

Testez gratuitement nos 1268 formations

pendant 10 jours !

Tester maintenant Afficher tous les abonnements
Lancez-vous dans la création d'un web service de type REST simple. Suivez les différentes étapes du processus.
07:20

Transcription

Maintenant que nous avons vu comment appeler un service REST, nous allons voir comment créer un service REST. C'est assez différent de ce qu'on a pu faire pour les Web Services jusqu'à maintenant puisque créer un service REST consiste à créer une page, une page qui doit être statique. Enfin, statique, c'est à dire plus exactement de type AWP. C'est pas exactement statique mais c'est une page dont l'url ne va pas changer, c'est surtout ça qui compte. Donc en fait, on doit créer une page, spécifiquement pour chacun des services. Là, je viens de créer une page, on va l'appeler par exemple, donc on va l'enregistrer, on va repartir sur l'histoire des animaux. On va l'appeler Liste_Animaux. C'est le nom de la page. Elle s'appelle plus exactement PAGE_Liste_Animaux. Et dans cette page, on ne va rien mettre en fait. En tout cas, pas sur le côté visuel puisqu'elle ne va servir qu'à renvoyer des informations. Ce qu'on fait en général à ce niveau-là, c'est de mettre un petit label histoire de savoir à quoi elle sert sinon à chaque fois qu'on va l'ouvrir, on va se demander ce que cette page fait là. Donc, ici, on écrit par exemple « Page sans affichage utilisée par un service REST ». Vous mettez plus de détails, évidemment en fonction de ce que vous en faites réellement. L'idée, après, c'est d'aller dans le code de la page. Et c'est ici que vous allez mettre le code qui doit donc renvoyer le résultat au site qui l'a appelé. Ici, ce que je veux faire, on vient de le voir par rapport au nom, c'est renvoyer la liste des animaux. Alors, on a déjà vu comment constituer la liste des animaux, on va refaire la même chose. On va créer un tableau avec la liste des animaux. On va sérialiser ce tableau dans une variable sous forme Jason ou XML. Et on va la renvoyer d'une certaine manière, vous allez voir. C'est assez simple, je repars sur mon tableau, je vais l'appeler animaux, tout simplement. Animaux est un tableau de chaîne. OK. Alors, il l'a mis en tant que variable globale puisque je suis dans les déclarations globales de la page. Mais ça, c'est tout à fait normal. Ensuite, je vais parcourir mon fichier animal, plutôt Animaux. Tout animaux. Et pour chaque animal trouvé, donc je vais l'ajouter, mon tableau ajoute, dans mon tableau Animaux et je vais ajouter, en l'occurrence, eh bien animaux.le nom, logiquement. Voilà. Maintenant, je vais définir une variable qui va servir à être renvoyée, à constituer le retour. Donc, je vais l'appeler par exemple Réponses est une chaîne ANSI, On a vu qu'il valait mieux prendre des chaines ANSI dans ces cas-là pour tout ce qui est Jason et XML. Et je vais sérialiser... Seriallise le tableau donc qui s'appelle gtabAnimaux dans la variable gsRéponses. Je vais faire du Jason, pourquoi pas, peu importe, vous faites ce que vous voulez. L'un ou l'autre, Jason ou XML. De toute façon, on va simplement visualiser le résultat. On ne va pas nécessairement le traiter. Donc la petite particularité, c'est qu'on ne va pas faire un renvoyé, on va simplement afficher le résultat. Donc, je vais utiliser la fonction ChaîneAffiche qui va donc afficher le contenu de la variable gsRéponses. On va voir tout de suite ce que ça donne, on va tester cette page. Je clique sur le bouton GO. Et vous voyez, directement, on peut la tester, la page renvoie le résultat demandé. Le problème, c'est que pour l'instant, c'est une page dynamique « normale ». Vous voyez que l'url est un peu bizarre et elle va changer au gré de l'usage. Donc là, il ne faut pas oublier ce que j'ai dit au début, la page devrait être de type AWP. Je reviens sur la page elle-même, je double-clique sur la page pour aller voir les propriétés, les descriptions. Et je coche « génération en mode AWP ». Ce qui signifie que la page va avoir une url entre autres, ça signifie plein d'autres choses. Mais ici, ce qui m'intéresse, c'est que la page va avoir une url fixe. Maintenant, si vous regardez ici, la page s'appelle, bien-sûr le debut d'url dépend du site web sur lequel vous l'installer. Ici, c'est un site de test, test en local. Donc, le nom de la page est ici, voilà. Là, on a bien une url fixe qui ne bougera pas. Après, on pourrait utiliser l'url writing qui est intégré dans webdev pour changer le nom de cet page. Pour avoir quelque chose du style lenomdusite/Liste-Animaux tout simplement, par exemple. C'est des choses que vous pouvez faire. Je viens de copier l'url parce que j'en ai besoin. Je vais la tester. Je vais quand même essayer de l'appeler depuis une application windev ou un site webdev, en l'occurrence un site WebDev puisqu'on est sur WebDev. Mais le résultat est le même. Donc, je copie l'url. Je peux le faire avec le même projet, en fin de compte, puisque la page étant une page figée et que je l'ai déjà testée, elle est donc dans la partie web, elle a été générée. Je vais aller dans une autre page, peut-être que je peux en créer une spécifiquement pour ce test-là, ou celle-ci, tenez, on avait déjà une page pour tester les services REST. Donc ça, c'était l'appel du service externe qu'on avait vu au départ. Eh bien, je vais ajouter un bouton qui va s'appeler liste animaux, par exemple Liste des animaux et qui va nous servir à teste l'appel de ce service REST. Donc, je vais ici taper le code nécessaire. Alors, je reprends le code qu'on a fait précédemment. On avait une requête, un appel. Je vais changer un peu le nom, je vais l'appeler MonAppel est un restRequête. MaRéponse est un restRéponse. Ensuite, vous vous souvenez, on prend la première variable et on lui définit sa propriété url avec l'url qu'on vient de copier de l'autre côté. Et je n'ai plus qu'à l'appeler en écrivant donc MaRéponse = RESTEnvoie(MonAppel) Maintenant, je vous épargne le test. On va partir du principe que ça fonctionne. On rajoutera si ça ne marche pas. Je vais donc afficher dans le champ résultat SAI_Texte 1. On a toujours pas changé de nom. Je vais donc y afficher MaRéponse.Contenu en brut mais ça devrait être suffisant pour le test. Là, quand je clique sur liste des animaux, voilà, j'ai bien le résultat brut, c'est un fichier, enfin, un fichier, disons que c'est un contenu Jason. Encore une fois, j'aurais pu le faire en XML. Donc, en vous basant sur ce qu'on a déjà vu, vous êtes capable d'extraire les différents animaux de cette liste pour les traiter et en faire ce dont vous avez besoin. Donc, vous avez vu ici comment créer un service REST assez simple qui se contente de renvoyer une information et afficher le résultat dans un champ. Nous allons voir maintenant comment créer un service REST un petit peu plus élaboré auquel on va pouvoir passer des paramètres.

WebDev 21 : Les web services

Créez et utilisez les web services et les services REST avec WebDev. Donnez l’accès à vos données et à vos services aux applications externes qui devront les utiliser.

1h59 (21 vidéos)
Aucun commentaire n´est disponible actuellement
 
Logiciel :
WebDev WebDev 21
Spécial abonnés
Date de parution :13 avr. 2016

Votre formation est disponible en ligne avec option de téléchargement. Bonne nouvelle : vous ne devez pas choisir entre les deux. Dès que vous achetez une formation, vous disposez des deux options de consultation !

Le téléchargement vous permet de consulter la formation hors ligne et offre une interface plus conviviale. Si vous travaillez sur différents ordinateurs ou que vous ne voulez pas regarder la formation en une seule fois, connectez-vous sur cette page pour consulter en ligne les vidéos de la formation. Nous vous souhaitons un excellent apprentissage avec cette formation vidéo.

N'hésitez pas à nous contacter si vous avez des questions !