Votre premier middleware
Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 13 sur 20.
Le middleware est un code que chaque requête traverse, dans l’ordre où l’application l’ajoute, avant qu’un point de terminaison ne réponde. app.Use en ajoute un. Il reçoit HttpContext, qui contient la requête et la réponse, ainsi que next, qui exécute le reste du pipeline.
app.Use(async (context, next) =>
{
context.Response.Headers["Cache-Control"] = "no-store";
await next();
});Le code avant await next() s’exécute à l’aller, et le code après s’exécute au retour. Une réponse envoie ses en-têtes avant son corps ; définis donc les en-têtes avant next() : une fois que le point de terminaison a écrit le corps, ils ne peuvent plus changer. Un middleware ne voit que les requêtes qui l’atteignent, et app.UseStaticFiles() répond lui-même à une requête de fichier ; un middleware ajouté après lui ne voit donc jamais /index.html.
Défi
FacileChaque réponse indique dans l’en-tête quelle version de l’API y a répondu : X-Api-Version: 1.
- Dans
Program.cs, entrevar app = builder.Build();etapp.UseStaticFiles();, ajoute un intergiciel avecapp.Use(async (context, next) => { ... });. - Il définit
context.Response.Headers["X-Api-Version"] = "1";, puis appelleawait next();.
Essaie : appuie sur « Exécuter ». GET /api/recipes répond comme avant, et son onglet Headers affiche X-Api-Version: 1. Envoie GET /index.html : l’en-tête est également présent. Envoie GET /nothing : statut 404, avec l’en-tête.
Essayez vous-même
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();
Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.
Toutes les leçons de Minimal APIs
1Premiers endpoints
Votre premier endpointRenvoyer du JSON4Middleware et journalisation
Votre premier middleware2Résultats et corps JSON
OK et introuvable