Deine erste Middleware
Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 13 von 20.
Middleware ist Code, den jede Anfrage in der Reihenfolge durchläuft, in der die App ihn hinzufügt, bevor ein Endpunkt antwortet. app.Use fügt eine Middleware hinzu. Sie erhält den HttpContext, der die Anfrage und die Antwort enthält, sowie next, das den Rest der Pipeline ausführt.
app.Use(async (context, next) =>
{
context.Response.Headers["Cache-Control"] = "no-store";
await next();
});Der Code vor await next() wird auf dem Weg hinein ausgeführt, der Code danach auf dem Weg hinaus. Eine Antwort sendet ihre Header vor ihrem Body, setze die Header also vor next(): Sobald ein Endpunkt den Body geschrieben hat, lassen sie sich nicht mehr ändern. Eine Middleware sieht nur die Anfragen, die sie erreichen, und app.UseStaticFiles() beantwortet eine Dateianfrage selbst, sodass eine darunter hinzugefügte Middleware /index.html nie sieht.
Aufgabe
EinfachJede Antwort gibt im Header X-Api-Version: 1 an, welche API-Version geantwortet hat.
- Füge in
Program.cszwischenvar app = builder.Build();undapp.UseStaticFiles();eine Middleware mitapp.Use(async (context, next) => { ... });hinzu. - Sie setzt
context.Response.Headers["X-Api-Version"] = "1";und ruft dannawait next();auf.
Probiere es aus: Drücke „Ausführen“. GET /api/recipes antwortet wie zuvor, und im Tab „Headers“ wird X-Api-Version: 1 angezeigt. Sende GET /index.html: Der Header ist auch hier vorhanden. Sende GET /nothing: Status 404, mit dem Header.
Probier es selbst
using Microsoft.AspNetCore.Http.HttpResults;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.UseStaticFiles();
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;
var favoriteIds = new List<int>();
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();
});
var favorites = app.MapGroup("/api/favorites");
favorites.MapGet("/", () => recipes.Where(r => favoriteIds.Contains(r.Id)));
favorites.MapPost("/{id:int}", (int id) =>
{
if (!recipes.Any(r => r.Id == id))
return Results.NotFound(new { error = $"Recipe {id} not found" });
if (!favoriteIds.Contains(id))
favoriteIds.Add(id);
return Results.NoContent();
});
favorites.MapDelete("/{id:int}", (int id) =>
{
favoriteIds.Remove(id);
return Results.NoContent();
});
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