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.
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.
- Trong
Program.cs, thêm tham số thứ haiILogger<Program> loggervào lambdaPOST /api/recipes. - Ngay sau
recipes.Add(recipe);, gọilogger.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
1Các endpoint đầu tiên
Endpoint đầu tiên của bạnTrả về JSON4Middleware và ghi nhật ký
Middleware đầu tiên của bạn2Kết quả và phần thân JSON
OK và không tìm thấy