Gruppi di route
Fa parte della sezione Minimal API del percorso ASP.NET Core di Coddy. Lezione 11 di 20.
Gli endpoint di una stessa risorsa condividono l'inizio dei loro percorsi. app.MapGroup(prefix) crea un gruppo di percorsi: ogni endpoint mappato su di esso riceve il prefisso davanti al proprio schema.
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));I percorsi sono /api/orders/, /api/orders/{id:int} e il DELETE sullo stesso schema. GET /api/orders corrisponde a /api/orders/, poiché una barra finale non cambia il percorso corrispondente. Il prefisso viene scritto una sola volta, quindi rinominarlo modifica una sola riga, e un gruppo può applicare impostazioni a tutti i suoi endpoint, come richiedere l'accesso. Riscrivere il prefisso all'interno del gruppo lo raddoppia: /api/orders/api/orders/{id:int}.
Sfida
FacileChi apprende può mantenere ricette preferite. I tre endpoint dei preferiti condividono un gruppo.
- In
Program.cs, sottonextId, aggiungivar favoriteIds = new List<int>();. - Sopra
app.Run(), crea il gruppo:var favorites = app.MapGroup("/api/favorites");. - Nel gruppo, associa GET
"/": restituisce le ricette il cuiIdè contenuto infavoriteIds, nell'ordine direcipes. - Associa POST
"/{id:int}": se nessuna ricetta ha quell'id, restituisciResults.NotFound(new { error = $"Recipe {id} not found" }). Altrimenti aggiungi l'id, a meno chefavoriteIdsnon lo contenga già, e restituisciResults.NoContent(). - Associa DELETE
"/{id:int}": rimuovi l'id dafavoriteIdse restituisciResults.NoContent().
Prova: premi Esegui: GET /api/favorites risponde []. Invia POST /api/favorites/2 con un corpo vuoto: stato 204. Invia GET /api/favorites: un elenco con la ricetta Pancakes. POST /api/favorites/99 risponde 404 e DELETE /api/favorites/2 svuota di nuovo l'elenco.
Provalo tu
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();
Questa lezione include un breve quiz. Inizia la lezione per rispondere e tenere traccia dei tuoi progressi.