Tu primer Middleware
Parte de la sección API mínimas del Journey de ASP.NET Core de Coddy. Lección 13 de 20.
El middleware es código por el que pasa cada solicitud, en el orden en que la aplicación lo añade, antes de que un punto de conexión responda. app.Use añade uno. Recibe HttpContext, que contiene la solicitud y la respuesta, y next, que ejecuta el resto de la canalización.
app.Use(async (context, next) =>
{
context.Response.Headers["Cache-Control"] = "no-store";
await next();
});El código antes de await next() se ejecuta a la ida, y el código después, a la vuelta. Una respuesta envía sus encabezados antes que el cuerpo, así que establece los encabezados antes de next(): una vez que un punto de conexión ha escrito el cuerpo, ya no pueden cambiarse. Un middleware solo ve las solicitudes que llegan hasta él, y app.UseStaticFiles() responde por sí mismo a una solicitud de archivo, así que un middleware añadido debajo de él nunca ve /index.html.
Desafío
FácilCada respuesta indica qué versión de la API la respondió, en el encabezado X-Api-Version: 1.
- En
Program.cs, entrevar app = builder.Build();yapp.UseStaticFiles();, agrega un middleware conapp.Use(async (context, next) => { ... });. - Este establece
context.Response.Headers["X-Api-Version"] = "1";y después llama aawait next();.
Pruébalo: pulsa Ejecutar. GET /api/recipes responde como antes y su pestaña Headers muestra X-Api-Version: 1. Envía GET /index.html: el encabezado también aparece. Envía GET /nothing: estado 404, con el encabezado.
Pruébalo tú mismo
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();
Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.
Todas las lecciones de API mínimas
1Primeros endpoints
Tu primer endpointDevolver JSON4Middleware y registro de logs
Tu primer Middleware2Resultados y cuerpos JSON
Correcto y no encontrado