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}.
Aufgabe
EinfachLernende können Lieblingsrezepte speichern. Die drei Favoriten-Endpunkte verwenden dieselbe Gruppe.
- Füge in
Program.csunternextIdvar favoriteIds = new List<int>();hinzu. - Erstelle die Gruppe oberhalb von
app.Run():var favorites = app.MapGroup("/api/favorites");. - Bilde auf der Gruppe GET
"/"ab: Es gibt die Rezepte zurück, derenIdinfavoriteIdsenthalten ist, und zwar in der Reihenfolge vonrecipes. - Bilde POST
"/{id:int}"ab: Wenn kein Rezept diese ID hat, gibResults.NotFound(new { error = $"Recipe {id} not found" })zurück. Füge die ID andernfalls hinzu, sofernfavoriteIdssie noch nicht enthält, und gibResults.NoContent()zurück. - Bilde DELETE
"/{id:int}"ab: Entferne die ID ausfavoriteIdsund gibResults.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();
Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.
Alle Lektionen in Minimal APIs
1Erste Endpoints
Dein erster EndpointJSON zurückgeben4Middleware und Protokollierung
Deine erste Middleware2Ergebnisse und JSON-Bodies
OK und Nicht gefunden