Menu
CoddyTech

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.

challenge icon

Défi

Facile

L’application consigne chaque recette qu’elle ajoute.

  1. Dans Program.cs, ajoute un deuxième paramètre à la lambda POST /api/recipes : ILogger<Program> logger.
  2. Juste après recipes.Add(recipe);, appelle logger.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