Menu
CoddyTech

Route-Gruppen

Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 11 von 20.

Endpunkte einer Ressource haben denselben Anfang in ihren Routen. app.MapGroup(prefix) erstellt eine Routengruppe: Jeder darauf abgebildete Endpunkt erhält das Präfix vor seinem eigenen Muster.

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));

Die Routen lauten /api/orders/, /api/orders/{id:int} sowie DELETE mit demselben Muster. GET /api/orders entspricht /api/orders/, da ein abschließender Schrägstrich nicht ändert, welche Route übereinstimmt. Das Präfix wird einmal angegeben. Wird es umbenannt, muss daher nur eine Zeile geändert werden. Außerdem kann eine Gruppe Einstellungen auf alle ihre Endpunkte anwenden, etwa eine Anmeldung voraussetzen. Wird das Präfix innerhalb der Gruppe erneut angegeben, wird es verdoppelt: /api/orders/api/orders/{id:int}.

challenge icon

Aufgabe

Einfach

Lernende können Lieblingsrezepte speichern. Die drei Favoriten-Endpunkte verwenden dieselbe Gruppe.

  1. Füge in Program.cs unter nextId var favoriteIds = new List<int>(); hinzu.
  2. Erstelle die Gruppe oberhalb von app.Run(): var favorites = app.MapGroup("/api/favorites");.
  3. Bilde auf der Gruppe GET "/" ab: Es gibt die Rezepte zurück, deren Id in favoriteIds enthalten ist, und zwar in der Reihenfolge von recipes.
  4. Bilde POST "/{id:int}" ab: Wenn kein Rezept diese ID hat, gib Results.NotFound(new { error = $"Recipe {id} not found" }) zurück. Füge die ID andernfalls hinzu, sofern favoriteIds sie noch nicht enthält, und gib Results.NoContent() zurück.
  5. Bilde DELETE "/{id:int}" ab: Entferne die ID aus favoriteIds und gib Results.NoContent() zurück.

Probiere es aus: Drücke auf „Ausführen“: GET /api/favorites liefert []. Sende POST /api/favorites/2 mit leerem Inhalt: Status 204. Sende GET /api/favorites: eine Liste mit dem Pancakes-Rezept. POST /api/favorites/99 liefert 404, und DELETE /api/favorites/2 leert die Liste wieder.

Probier es selbst

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 iconTeste dich selbst

Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.

Alle Lektionen in Minimal APIs