Menu
CoddyTech

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.

challenge icon

Aufgabe

Einfach

Jede Antwort gibt im Header X-Api-Version: 1 an, welche API-Version geantwortet hat.

  1. Füge in Program.cs zwischen var app = builder.Build(); und app.UseStaticFiles(); eine Middleware mit app.Use(async (context, next) => { ... }); hinzu.
  2. Sie setzt context.Response.Headers["X-Api-Version"] = "1"; und ruft dann await 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();
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