Consommer des webservices

Introduction

De nombreuses applications utilisent des données distantes pour fonctionner. Il s’agit en réalité d’applications clientes consommant des services web.

Ces services peuvent avoir différentes topologies et utiliser différentes technologies. Dans ce chapitre, nous aborderons les principaux types de services web que sont les services REST.

1. Verbes HTTP

REST (Representational State Transfer) est un protocole basé sur des requêtes effectuées via le protocole HTTP et les verbes associés :

GET : utilisé pour la récupération de données. Il est notamment utilisé par les navigateurs web pour afficher des pages.
POST : utilisé pour ajouter des données depuis le client vers le serveur.
PUT : modifie des données existantes dans le cadre de mise à jour de celles-ci.
DELETE : supprime des données sur le serveur.

Si l’on devait prendre un exemple simple pour illustrer l’usage de ces verbes, voici ce que l’on pourrait imaginer :

GET /users : récupère la liste des utilisateurs.
POST /users : ajoute un utilisateur.
PUT /users/1 : modifie l’utilisateur dont l’identifiant est 1.
DELETE /users/1 : supprime l’utilisateur dont l’identifiant est 1.

2. Création de requêtes

a. API

Tout d’abord, il est important de distinguer les API permettant de créer les requêtes.

Historiquement, il fallait utiliser System.Net.Http.HttpClient, introduite avec .NET4.5.

Depuis la sortie de Windows 10, une nouvelle API est disponible : Windows.Web.Http.HttpClient. Celle-ci est fortement recommandée par Microsoft.

Les différences majeures sont que la nouvelle API a peu de dépendances aux couches bas niveau de Windows et que celle-ci est plus adaptée aux fonctionnalités du protocole HTTP, telles que les WebSockets.

L’ancienne API, System.Net.Http, est toujours présente, disponible dans les bibliothèques de classes portables et de nombreuses documentations en ligne, dont la documentation officielle de Xamarin, l’utilisent toujours. Ainsi, ce chapitre se basera sur son usage. Gardez simplement en tête que, dans le cadre d’une application UWP, l’API Windows.Web.Http est fortement conseillée.

b. Création de requêtes

Une fois que le choix de l’API est décidé...

Conclusion

Dans ce chapitre, nous avons vu comment consommer les services web les plus courants, à savoir les services REST.

Il existe évidemment bien d’autres protocoles, tels que le XML-RPC ou SOAP, mais leurs usages sont très restreints et limités à des contraintes particulières. Avec REST, vous aurez les clés pour bien débuter votre usage des services web.

L’utilisation de la classe HttpClient est si complète que nous vous invitons à en lire les spécifications pour en connaître tous les rouages.