Journaliser avec ILogger
Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 15 sur 20.
Console.WriteLine affiche du texte, et rien de plus. Un journaliseur écrit chaque ligne avec un niveau et une catégorie, et les paramètres de l’application déterminent quelles lignes sont conservées. Un point de terminaison en reçoit un en le déclarant comme paramètre : ASP.NET Core transmet des services tels que ILogger<T> à toute lambda qui en demande un.
app.MapPost("/orders", (NewOrder input, ILogger<Program> logger) =>
{
logger.LogInformation("Order of {Count} items for {Customer}", input.Count, input.Customer);
return Results.Ok();
});Le message est un modèle : chaque {Name} est remplacé par l’argument suivant, dans l’ordre, et le journaliseur conserve les valeurs sous forme de champs nommés que les outils de journalisation peuvent rechercher. La Console affiche info: Program[0], puis le message à la ligne suivante : le niveau, la catégorie (Program, issu de ILogger<Program>) et un identifiant d’événement.
Défi
FacileL’application consigne chaque recette qu’elle ajoute.
- Dans
Program.cs, ajoute un deuxième paramètre à la lambdaPOST /api/recipes:ILogger<Program> logger. - Juste après
recipes.Add(recipe);, appellelogger.LogInformation("Added recipe {Id}: {Name}", recipe.Id, recipe.Name);.
Essaie : appuie sur « Exécuter » et envoie une requête POST avec {"name":"Waffles","category":"breakfast","minutes":20} à /api/recipes. La Console affiche info: Program[0] et Added recipe 4: Waffles. Envoie une requête POST avec {"minutes":5} : le statut est 400 et aucune ligne n’est consignée.
Essayez vous-même
using Microsoft.AspNetCore.Http.HttpResults;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.Use(async (context, next) =>
{
context.Response.Headers["X-Api-Version"] = "1";
await next();
});
app.Use(async (context, next) =>
{
if (context.Request.Path.StartsWithSegments("/recipes"))
{
context.Response.Redirect("/api" + context.Request.Path + context.Request.QueryString, permanent: true);
return;
}
await next();
});
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();
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