Menu
CoddyTech

Il tuo primo middleware

Fa parte della sezione Minimal API del percorso ASP.NET Core di Coddy. Lezione 13 di 20.

Il middleware è codice attraverso cui passa ogni richiesta, nell’ordine in cui l’app lo aggiunge, prima che un endpoint risponda. app.Use ne aggiunge uno. Riceve HttpContext, che contiene la richiesta e la risposta, e next, che esegue il resto della pipeline.

app.Use(async (context, next) =>
{
    context.Response.Headers["Cache-Control"] = "no-store";
    await next();
});

Il codice prima di await next() viene eseguito durante il percorso in entrata, quello dopo durante il percorso in uscita. Una risposta invia le intestazioni prima del corpo, quindi imposta le intestazioni prima di next(): una volta che un endpoint ha scritto il corpo, non è più possibile modificarle. Un middleware vede solo le richieste che lo raggiungono, e app.UseStaticFiles() risponde direttamente a una richiesta di file, quindi un middleware aggiunto dopo di esso non vedrà mai /index.html.

challenge icon

Sfida

Facile

Ogni risposta indica nell’intestazione quale versione dell’API ha risposto: X-Api-Version: 1.

  1. In Program.cs, tra var app = builder.Build(); e app.UseStaticFiles();, aggiungi un middleware con app.Use(async (context, next) => { ... });.
  2. Imposta context.Response.Headers["X-Api-Version"] = "1";, poi chiama await next();.

Prova: premi «Esegui». GET /api/recipes risponde come prima e la scheda Headers mostra X-Api-Version: 1. Invia GET /index.html: anche qui l’intestazione è presente. Invia GET /nothing: stato 404, con l’intestazione.

Provalo tu

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