Menu
CoddyTech

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.

challenge icon

Desafío

Fácil

Cada respuesta indica qué versión de la API la respondió, en el encabezado X-Api-Version: 1.

  1. En Program.cs, entre var app = builder.Build(); y app.UseStaticFiles();, agrega un middleware con app.Use(async (context, next) => { ... });.
  2. Este establece context.Response.Headers["X-Api-Version"] = "1"; y después llama a await 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();
quiz iconPonte a prueba

Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.

Todas las lecciones de API mínimas