Connexion des commandes POST: Une analyse approfondie par Tim Corey

Introduction aux commandes POST

Tim commence par revisiter les mises à jour de l'interface de la leçon précédente, notant que le système ne supporte actuellement que les requêtes GET. Il explique que cette leçon se concentre sur l'activation des requêtes POST pour que les utilisateurs puissent envoyer des données à un serveur, comme des sorties JSON ou des données de formulaire.

Il insiste sur le fait que la séparation du code de l'UI du code de la bibliothèque est essentielle. L'UI doit gérer les éléments comme les menus déroulants, les formulaires HTML, et les champs de saisie, tandis que la bibliothèque gère la création de requêtes HTTP, le formatage du contenu, et l'envoi de données au serveur.

Tim note aussi que ce projet peut servir d'exemple de portefeuille, mais qu'il est important pour les développeurs de s'assurer que leur portefeuille leur est unique. Il fait référence à son Dev Pass sur timcorey.com comme moyen d'approfondir la compréhension de C# et des méthodes de requête HTTP.

Comprendre la configuration actuelle

Dans Visual Studio, Tim montre la configuration actuelle du projet. L'UI permet la sélection d'une méthode de requête (GET ou POST) et la saisie d'une URL. Actuellement, cliquer sur "Lancer" n'exécute qu'une requête GET, affichant la réponse dans une fenêtre de résultats.

Un petit problème qu'il souligne est que tout le texte de la fenêtre de résultats est mis en surbrillance après une requête GET, ce qui n'est pas idéal pour afficher des informations. Tim corrige cela en mettant le focus sur l'élément de l'onglet à la place de la boîte de texte. Cela empêche la sélection automatique du texte et améliore l'expérience utilisateur.

Lire le menu déroulant et déterminer l'action HTTP

Pour implémenter les commandes POST, Tim explique d'abord comment lire la sélection du menu déroulant pour déterminer la méthode de requête HTTP. Il crée une variable pour stocker la méthode de requête analysée et utilise TryParse pour convertir la valeur de chaîne du menu déroulant en une action HTTP.

Si la méthode sélectionnée est invalide, le système affiche un message d'erreur ("Verbe HTTP invalide") et n'essaie pas d'effectuer la requête. Une fois validée, la méthode de requête peut être utilisée pour déterminer s'il s'agit d'effectuer une requête GET, POST, ou d'autres méthodes HTTP comme DELETE ou PATCH.

Préparer le backend pour gérer les requêtes POST

L'étape suivante consiste à mettre à jour la bibliothèque pour gérer les requêtes POST. Tim explique que les commandes POST diffèrent des requêtes GET car elles nécessitent généralement un corps de requête pour envoyer des données à la ressource cible. Ces données pourraient être du JSON, des données binaires, ou des données de formulaire.

Tim insiste sur la séparation des responsabilités de l'UI du code de la bibliothèque. L'UI passe le contenu du corps sous forme de chaîne, et la bibliothèque le convertit en type de contenu HTTP correct pour la requête. Ce design garantit que les opérations génériques comme le formatage du contenu sont traitées dans la bibliothèque, pas dans l'UI.

Créer une surcharge pour les requêtes POST

Tim crée une surcharge pour CallApiAsync qui accepte trois paramètres :

1. URL – l'adresse de la ressource cible

2. Action – la méthode de requête HTTP (GET, POST, etc.)

3. Content – le corps de la requête sous forme de chaîne

Cela permet aux développeurs de passer une sortie JSON, des données de formulaire, ou d'autres données encodées directement de l'UI à la bibliothèque. En gérant les requêtes POST de cette manière, la même bibliothèque peut également prendre en charge les méthodes HTTP futures, telles que PUT, PATCH, ou DELETE.

Convertir le contenu de chaîne en contenu HTTP

Tim montre comment convertir le contenu de la chaîne de l'UI en StringContent, qui hérite du contenu HTTP. Il définit l'encodage sur UTF8 et le type de contenu sur application/json, ce qui convient pour envoyer des données structurées à un serveur.

Cette étape garantit que le corps de la requête est correctement formaté avant l'envoi. Tim souligne que cette séparation des préoccupations permet aux développeurs d'utiliser les commandes POST sans se soucier des en-têtes HTTP, de l'encodage, ou de la conversion de contenu dans l'UI.

Mise à jour de l'interface et test des requêtes POST

Une fois la bibliothèque prête, Tim met à jour l'UI pour appeler la nouvelle méthode surchargée. Il teste les requêtes POST en utilisant JSONPlaceholder, en formatant manuellement le corps de la requête :

{
  "title": "Voici mon titre",
  "body": "Voici mon texte de corps",
  "userId": 3
}

Tim explique qu'une requête POST envoie ces données à la ressource cible, et que la réponse indique le succès. Initialement, une erreur se produit car l'énumération d'actions HTTP n'inclut pas POST. L'ajout de POST résout cela, permettant au système d'envoyer les commandes POST avec succès.

Gérer les requêtes POST dans la bibliothèque

Tim démontre la gestion des commandes POST dans la bibliothèque en utilisant une instruction switch sur la méthode de requête HTTP. Pour GET, le système utilise GetAsync; pour POST, il utilise PostAsync avec le corps de requête formaté.

Tester la commande POST renvoie une réponse avec un ID (101 dans JSONPlaceholder), confirmant que la requête a fonctionné. Tim note que bien que cette API de test ne stocke pas les données dans une base de données, elle est utile pour valider la fonctionnalité de la requête POST.

Points clés et travaux futurs

Tim résume la leçon :

• Le menu déroulant prend désormais en charge les méthodes GET et POST.

• L'UI passe le corps de la requête à la bibliothèque.

• La bibliothèque convertit la chaîne en contenu HTTP et exécute la requête HTTP correcte.

• Les commandes POST renvoient des réponses valides, qui peuvent être affichées dans la fenêtre des résultats.

Il encourage les apprenants à implémenter les commandes PUT, PATCH, et DELETE dans les leçons futures, en soulignant que le cadre existant rend l'ajout de nouvelles méthodes HTTP simple.

Tim conseille également d'éviter la suringénierie ou l'ajout de code inutilisé, ce qui pourrait entraîner des fonctions déconnectées ou des éléments orphelins.

Conclusion

La vidéo de Tim Corey offre une approche claire et pratique des commandes POST dans un projet de clone de Postman. En séparant les responsabilités de l'UI du code de la bibliothèque, en convertissant les données de chaîne en contenu HTTP, et en gérant efficacement les réponses, les développeurs acquièrent une expérience pratique avec les méthodes de requête HTTP.

Cette leçon ne démontre pas seulement l'envoi de données à un serveur, mais pose aussi les bases pour gérer d'autres méthodes HTTP, en-têtes, et demandes plus complexes, en faisant un exemple pratique solide pour apprendre les interactions HTTP en C#.