Le 14 septembre 2017, nous avons publié une version actualisée de notre Politique de confidentialité. En utilisant video2brain.com vous vous engagez à respecter ces documents mis à jour. Veuillez donc prendre quelques minutes pour les consulter.

Découvrir ASP.NET Core 1.0

Concevoir une API web

TESTEZ LINKEDIN LEARNING GRATUITEMENT ET SANS ENGAGEMENT

Tester maintenant Afficher tous les abonnements
Proposez une API simple et efficace utilisant vos entités. Apprenez également à respecter les principes des API RESTful.
06:13

Transcription

Nous allons maintenant voir comment faire une API web, enrichir notre site web d'une API, qui va permettre à des applications mobiles ou d'autres parties de notre site d'accéder aux données du site depuis l'extérieur. Alors pour ça, on va rajouter un contrôleur spécial qui est un contrôleur d'API web. Ce contrôleur va s'appeler par exemple Sorciers, pour les ressources distribuées. C'est toujours une ressource qu'on distribue au travers d'une API. Et puis, ici, on va donc pouvoir implémenter différentes opérations alors, de création de la ressource, avec Post, de récupération de la ressource, ici avec Get, soit une liste, soit un seul élément. Et puis Put pour modifier, Delete pour supprimer. Pour mes sorciers, j'ai pas envie ni de les modifier, ni de les supprimer, donc je supprime le Put et le Delete. Par contre ces opérations m'intéressent, mais pas telles quelles. Déjà, c'est sur des sorciers qu'elles vont se produire, donc il faut que je fournisse un objet de type Sorcier. Pour cette liste-là. Et puis, en plus, j'ai déjà de quoi travailler avec de tels objets, de telles entités, puisque j'ai un contexte GrimoireContext qui va me permettre de facilement travailler avec. Alors, il faut que je déclare ce champ privé. GrimoireContext context Et donc ici déjà qu'on me demande la liste des sorciers, je réponds sans problème avec simplement cette liste. C'est beaucoup plus délicat quand on me demande qu'un seul sorcier, puisqu'il peut ne pas être trouvé. Il se peut que l'identifiant que l'on me passe dans cette URL API slash, là ce sera sorciers au pluriel, slash cinq, ce ne soit pas trouvé. Alors pour ça, donc, il ne faut pas retourner ni un sorcier, ni un type chaîne. Il vaut mieux, comme on le faisait dans le contrôleur, en AsyncResult, qui nous donne le choix vraiment de ce que l'on veut retourné. Alors, qu'est-ce que l'on veut retourné ? Déjà il faut chercher le sorcier. Pour ça donc, on va faire une requête link donc from s in, context.Sorciers, voilà. where s point Id égal égal Id. Et là donc je sélectionne le sorcier en question. Mais s'il n'existe pas, il faut que j'affecte autre chose. Donc je vais affecter nul. FirstOrDefault Voilà, qui est un bon moyen de récupérer la valeur nul si je n'ai rien. Et donc là maintenant je teste. Si sorcier vaut nul, alors selon les règles des API web, on doit retourner un code d'erreur qui correspond à « non trouvé ». Et c'est le 404, le « not found », qui est le code d'erreur parfait pour ça. Et puis, si on trouve ici alors, not found est un NotFound result. J'ai mis AsyncResult, pas AsyncResult. C'est bien sûr ActionResult. Et donc ce ActionResult va être ici un sorcier, donc je vais dire Ok. Et, puisque je l'ai trouvé, donc je retourne Ok et je lui demande d'envoyer le sorcier dans le corps de la réponse, puisque je l'ai trouvé Pour le Post, il va falloir créer, mais si on a le moindre problème à la création, problème de connexion à la base de données, etc. il faudra retourner une erreur, donc là aussi, un ActionResult qui va consister en StatusCode 500, quand il y a une erreur interne du serveur. Et sinon, on essaye donc de sauver. Pour ça donc, on ajoute le sorcier qu'on a reçu en paramètre sous la forme d'un code JSON, en fait, on le reçoit, et j'ajoute donc ce sorcier à la liste des sorciers, et puis je sauve les changements. Sorciers Select Change pas sur Sorciers, mais sur le contexte, puisque c'est le contexte qui va sauver les changements, et je retourne bien sûr que je l'ai créé. Il y a un code spécifique, Created et le Created doit renvoyer l'URL puisque il est un identifiant, cet objet créé, donc on va récupérer la valeur de l'identifiant ici et la passer dans la réponse. Donc ici on la crée à cet endroit-là avec un identifiant. Donc maintenant l'objet sera accessible là. Voilà, et on en informe la personne qui a demandé à créer l'objet. Donc on demande à créer un sorcier par notre API. Nous on répond en disant qu'on a créé, code 201, et retourne l'identifiant, pour que la personne puisse utiliser l'objet créé. Donc on peut lancer. Et donc à l'URL de mon API sorciers, j'énumère la liste des sorciers dont j'ai un résultat JSON, c'est normal. Et ici donc j'obtiens Merlin, le sorcier d'identifiant 1. Donc on a une API pour accéder à nos sorciers.

Découvrir ASP.NET Core 1.0

Prenez en main ASP.NET Core 1.0. Développez ainsi des applications web multiplateformes en C#, déployables sur Windows, Linux, Mac ainsi qu'en containers Dockers.

1h32 (20 vidéos)
Aucun commentaire n´est disponible actuellement
 
Logiciel :
ASP.NET Core ASP.NET Core 1
Spécial abonnés
Date de parution :1 févr. 2017

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 !