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.
Sfida
FacileOgni risposta indica nell’intestazione quale versione dell’API ha risposto: X-Api-Version: 1.
- In
Program.cs, travar app = builder.Build();eapp.UseStaticFiles();, aggiungi un middleware conapp.Use(async (context, next) => { ... });. - Imposta
context.Response.Headers["X-Api-Version"] = "1";, poi chiamaawait 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();
Questa lezione include un breve quiz. Inizia la lezione per rispondere e tenere traccia dei tuoi progressi.
Tutte le lezioni di Minimal API
1I primi endpoint
Il tuo primo endpointRestituire JSON4Middleware e logging
Il tuo primo middleware