Menu
CoddyTech

Ghi nhật ký với ILogger

Thuộc phần Minimal API trong hành trình ASP.NET Core của Coddy. Bài học 15 trên 20.

Console.WriteLine in văn bản, không làm gì khác. Bộ ghi nhật ký ghi từng dòng kèm theo cấp độ và danh mục, còn cài đặt của ứng dụng quyết định những dòng nào được giữ lại. Một endpoint có thể nhận bộ ghi nhật ký bằng cách khai báo nó làm tham số: ASP.NET Core truyền các dịch vụ như ILogger<T> cho mọi lambda yêu cầu chúng.

app.MapPost("/orders", (NewOrder input, ILogger<Program> logger) =>
{
    logger.LogInformation("Order of {Count} items for {Customer}", input.Count, input.Customer);
    return Results.Ok();
});

Thông báo này là một mẫu: mỗi {Name} được điền bằng đối số tiếp theo theo thứ tự, và bộ ghi nhật ký lưu các giá trị dưới dạng trường có tên để các công cụ nhật ký có thể tìm kiếm. Console hiển thị info: Program[0], rồi đến thông báo ở dòng bên dưới: cấp độ, danh mục (Program, từ ILogger<Program>) và mã sự kiện.

challenge icon

Thử thách

Dễ

Ứng dụng ghi nhật ký mỗi công thức mà ứng dụng thêm vào.

  1. Trong Program.cs, thêm tham số thứ hai ILogger<Program> logger vào lambda POST /api/recipes.
  2. Ngay sau recipes.Add(recipe);, gọi logger.LogInformation("Added recipe {Id}: {Name}", recipe.Id, recipe.Name);.

Thử nhé: nhấn Chạy rồi gửi POST {"name":"Waffles","category":"breakfast","minutes":20} đến /api/recipes. Console hiển thị info: Program[0] và Added recipe 4: Waffles. Gửi POST {"minutes":5}: trạng thái 400 và không có dòng nào được ghi nhật ký.

Tự làm thử

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();

Tất cả bài học trong Minimal API