Traiter les données JSON dans ASP.NET Core : Un guide complet
L'utilisation de JSON est devenue la norme dans le développement web moderne, et ASP.NET Core offre une intégration transparente pour le traitement de ces données. Dans cet article, nous allons explorer les différentes façons de gérer les données JSON dans vos applications ASP.NET Core, de la désérialisation des requêtes entrantes à la construction de réponses JSON.
1. Désérialiser les données JSON en objets C#
La première étape pour utiliser les données JSON dans votre application ASP.NET Core est de les convertir en objets C# utilisables. Pour ce faire, vous pouvez utiliser la classe JsonSerializer de .NET. Voici un exemple simple :
using System.Text.Json;
// Code de l'exemple
var jsonString = "{ \"name\": \"John Doe\", \"age\": 30 }";
// Désérialisation du JSON en objet User
var user = JsonSerializer.Deserialize(jsonString);
// Affichage des propriétés de l'objet
Console.WriteLine($"Name: {user.Name}");
Console.WriteLine($"Age: {user.Age}");
Dans cet exemple, User est un objet C# avec des propriétés Name et Age. JsonSerializer.Deserialize<User>(jsonString) convertit le JSON en un objet User.
2. Modèles de liaison de données et JSON
ASP.NET Core utilise un système de liaison de données pour mapper les données de requêtes HTTP à des objets C#. Pour les requêtes avec un corps JSON, la liaison de données fonctionne automatiquement, sans que vous ayez à écrire du code supplémentaire. Voici un exemple de contrôleur avec une action qui prend un objet JSON en entrée :
using Microsoft.AspNetCore.Mvc;
// Code de l'exemple
[HttpPost]
public IActionResult CreateUser([FromBody] User user)
{
// Utilisation de l'objet user pour enregistrer les données
// ...
return Ok();
}
L'attribut [FromBody] indique à ASP.NET Core de lier le corps de la requête JSON à l'objet User.
3. Créer des réponses JSON
Lorsqu'une action de contrôleur ASP.NET Core retourne un objet C#, ASP.NET Core le sérialise automatiquement en JSON et l'envoie au client. Vous pouvez également contrôler la sérialisation en utilisant l'objet JsonResult. Voici un exemple:
using Microsoft.AspNetCore.Mvc;
// Code de l'exemple
[HttpGet]
public IActionResult GetUsers()
{
// Obtenir les utilisateurs à partir de la base de données
var users = GetUsersFromDatabase(); // Méthode fictive
// Créer un objet JsonResult avec les données
var response = new JsonResult(users);
// Retourner la réponse JSON
return response;
}
4. Personnaliser la sérialisation JSON
Si vous avez besoin d'une sérialisation JSON personnalisée, vous pouvez configurer ASP.NET Core pour utiliser des options de sérialisation spécifiques. Vous pouvez contrôler les noms de propriétés, les types de données sérialisés et d'autres aspects de la sérialisation.
Conclusion
Traiter les données JSON dans vos applications ASP.NET Core est une tâche courante et facile. En utilisant les outils fournis par ASP.NET Core, vous pouvez désérialiser les données JSON, les mapper à des objets C#, construire des réponses JSON et personnaliser la sérialisation pour répondre aux besoins spécifiques de votre application.