Menu
CoddyTech

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}.

challenge icon

Sfida

Facile

Chi apprende può mantenere ricette preferite. I tre endpoint dei preferiti condividono un gruppo.

  1. In Program.cs, sotto nextId, aggiungi var favoriteIds = new List<int>();.
  2. Sopra app.Run(), crea il gruppo: var favorites = app.MapGroup("/api/favorites");.
  3. Nel gruppo, associa GET "/": restituisce le ricette il cui Id è contenuto in favoriteIds, nell'ordine di recipes.
  4. Associa POST "/{id:int}": se nessuna ricetta ha quell'id, restituisci Results.NotFound(new { error = $"Recipe {id} not found" }). Altrimenti aggiungi l'id, a meno che favoriteIds non lo contenga già, e restituisci Results.NoContent().
  5. Associa DELETE "/{id:int}": rimuovi l'id da favoriteIds e restituisci Results.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();
quiz iconMettiti alla prova

Questa lezione include un breve quiz. Inizia la lezione per rispondere e tenere traccia dei tuoi progressi.

Tutte le lezioni di Minimal API