Groupes de routes
Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 11 sur 20.
Les points de terminaison d’une même ressource partagent le début de leurs routes. app.MapGroup(prefix) crée un groupe de routes : chaque point de terminaison qui y est mappé reçoit le préfixe devant son propre modèle.
var orders = app.MapGroup("/api/orders");
orders.MapGet("/", () => orderList);
orders.MapGet("/{id:int}", (int id) => orderList.FirstOrDefault(o => o.Id == id));
orders.MapDelete("/{id:int}", (int id) => orderList.RemoveAll(o => o.Id == id));Les routes sont /api/orders/, /api/orders/{id:int} et la requête DELETE sur le même modèle. GET /api/orders correspond à /api/orders/, car une barre oblique finale ne change pas la route correspondante. Le préfixe n’est écrit qu’une seule fois : le renommer ne nécessite donc de modifier qu’une ligne, et un groupe peut appliquer des paramètres à tous ses points de terminaison, par exemple exiger une connexion. Réécrire le préfixe à l’intérieur du groupe le double : /api/orders/api/orders/{id:int}.
Défi
FacileLes apprenants peuvent conserver leurs recettes préférées. Les trois points de terminaison des favoris partagent un même groupe.
- Dans
Program.cs, sousnextId, ajoutevar favoriteIds = new List<int>();. - Au-dessus de
app.Run(), crée le groupe :var favorites = app.MapGroup("/api/favorites");. - Sur le groupe, associe GET à
"/": il renvoie les recettes dontIdfigure dansfavoriteIds, dans l’ordre derecipes. - Associe POST à
"/{id:int}": si aucune recette ne possède cet identifiant, renvoieResults.NotFound(new { error = $"Recipe {id} not found" }). Sinon, ajoute l’identifiant sauf sifavoriteIdsle contient déjà, puis renvoieResults.NoContent(). - Associe DELETE à
"/{id:int}": supprime l’identifiant defavoriteIdset renvoieResults.NoContent().
Essaie : appuie sur Exécuter : GET /api/favorites renvoie []. Envoie POST /api/favorites/2 avec un corps vide : statut 204. Envoie GET /api/favorites : une liste contenant la recette Pancakes. POST /api/favorites/99 renvoie 404, et DELETE /api/favorites/2 vide à nouveau la liste.
Essayez vous-même
using Microsoft.AspNetCore.Http.HttpResults;
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),
};
var nextId = 4;
app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", (string? category) =>
recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) =>
{
var recipe = recipes.FirstOrDefault(r => r.Id == id);
if (recipe is null)
return Results.NotFound(new { error = $"Recipe {id} not found" });
return Results.Ok(recipe);
});
app.MapPost("/api/recipes", (NewRecipe input) =>
{
if (string.IsNullOrWhiteSpace(input.Name))
return Results.BadRequest(new { error = "Name is required" });
if (input.Minutes <= 0)
return Results.BadRequest(new { error = "Minutes must be more than 0" });
var recipe = new Recipe(nextId++, input.Name, input.Category, input.Minutes);
recipes.Add(recipe);
return Results.Created($"/api/recipes/{recipe.Id}", recipe);
});
app.MapPut("/api/recipes/{id:int}", (int id, NewRecipe input) =>
{
var index = recipes.FindIndex(r => r.Id == id);
if (index == -1)
return Results.NotFound(new { error = $"Recipe {id} not found" });
var recipe = new Recipe(id, input.Name, input.Category, input.Minutes);
recipes[index] = recipe;
return Results.Ok(recipe);
});
app.MapDelete("/api/recipes/{id:int}", Results<NoContent, NotFound> (int id) =>
{
var removed = recipes.RemoveAll(r => r.Id == id);
return removed > 0 ? TypedResults.NoContent() : TypedResults.NotFound();
});
app.Run();
Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.