Your First Middleware
Part of the Minimal APIs section of Coddy's ASP.NET Core journey. Lesson 13 of 20.
Middleware is code every request passes through, in the order the app adds it, before an endpoint answers. app.Use adds one. It gets the HttpContext, which holds the request and the response, and next, which runs the rest of the pipeline.
app.Use(async (context, next) =>
{
context.Response.Headers["Cache-Control"] = "no-store";
await next();
});Code before await next() runs on the way in, code after it on the way back out. A response sends its headers before its body, so set headers before next(): once an endpoint has written the body, they can no longer change. A middleware sees only the requests that reach it, and app.UseStaticFiles() answers a file request itself, so a middleware added below it never sees /index.html.
Challenge
EasyEvery response says which version of the API answered it, in the header X-Api-Version: 1.
- In
Program.cs, betweenvar app = builder.Build();andapp.UseStaticFiles();, add a middleware withapp.Use(async (context, next) => { ... });. - It sets
context.Response.Headers["X-Api-Version"] = "1";, then callsawait next();.
Try it: press Run. GET /api/recipes answers as before, and its Headers tab shows X-Api-Version: 1. Send GET /index.html: the header is there too. Send GET /nothing: status 404, with the header.
Try it yourself
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();
This lesson includes a short quiz. Start the lesson to answer it and track your progress.
All lessons in Minimal APIs
4Middleware and Logging
Your First Middleware2Results and JSON Bodies
Ok and Not Found