Chaînes de requête
Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 5 sur 20.
Une chaîne de requête est la partie d’une adresse qui suit ? : des paires nom-valeur reliées par &, comme dans /books?author=austen&page=2. Elle ne choisit pas la route ; elle ajoute des options à la requête. Un paramètre lambda dont le nom ne figure pas dans la route est lu dans la chaîne de requête.
app.MapGet("/books", (string? author, int page = 1) =>
$"Books by {author ?? "anyone"}, page {page}");GET /books?author=austen renvoie Books by austen, page 1. Un paramètre nullable, comme string?, ou qui a une valeur par défaut est facultatif. Un string simple est obligatoire : sans lui, ASP.NET Core renvoie 400 Bad Request et la lambda ne s’exécute jamais.
Défi
FacileGET /api/recipes apprend à filtrer : ?category=soup ne conserve que les soupes.
- Dans
Program.cs, donne à la lambdaGET /api/recipesun paramètrestring? category. - Renvoie les recettes dont
Categoryest égal àcategory. Lorsquecategoryestnull, renvoie toutes les recettes :recipes.Where(r => category is null || r.Category == category).
Essaie : appuie sur « Exécuter ». GET /api/recipes?category=soup renvoie les deux soupes, d’ids 1 et 3. Envoie GET /api/recipes : les trois recettes. Envoie GET /api/recipes?category=dessert : une liste vide, [].
Essayez vous-même
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var recipes = new List<Recipe>
{
new(1, "Tomato Soup", "soup", 25),
new(2, "Pancakes", "breakfast", 15),
new(3, "Lentil Soup", "soup", 40),
};
app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", () => recipes);
app.MapGet("/api/recipes/{id:int}", (int id) => recipes.FirstOrDefault(r => r.Id == id));
app.Run();
Toutes les leçons de Minimal APIs
1Premiers endpoints
Votre premier endpointRenvoyer du JSON2Résultats et corps JSON
OK et introuvable