רישום לוגים באמצעות ILogger
חלק מהיחידה Minimal APIs במסלול ה-ASP.NET Core של Coddy. שיעור 15 מתוך 20.
Console.WriteLine מדפיסה טקסט ולא יותר. יומן כותב כל שורה יחד עם רמה וקטגוריה, וההגדרות של האפליקציה קובעות אילו שורות נשמרות. נקודת קצה מקבלת יומן כשמציינים אותו כפרמטר: ASP.NET Core מעביר שירותים כגון ILogger<T> לכל פונקציה אנונימית שמבקשת זאת.
app.MapPost("/orders", (NewOrder input, ILogger<Program> logger) =>
{
logger.LogInformation("Order of {Count} items for {Customer}", input.Count, input.Customer);
return Results.Ok();
});ההודעה היא תבנית: כל {Name} מוחלף בארגומנט הבא, לפי הסדר, והיומן שומר את הערכים כשדות בעלי שמות שכלי רישום יכולים לחפש. במסוף מופיע info: Program[0], ולאחר מכן ההודעה בשורה שמתחת: הרמה, הקטגוריה (Program, מתוך ILogger<Program>) ומזהה אירוע.
אתגר
קלהאפליקציה רושמת ביומן כל מתכון שהיא מוסיפה.
- ב־
Program.cs, הוסיפו פרמטר שני ללמבדה שלPOST /api/recipes:ILogger<Program> logger. - מיד אחרי
recipes.Add(recipe);, קראו ל־logger.LogInformation("Added recipe {Id}: {Name}", recipe.Id, recipe.Name);.
נסו זאת: לחצו על „הרצה” ושלחו בקשת POST עם {"name":"Waffles","category":"breakfast","minutes":20} אל /api/recipes. במסוף מופיעים info: Program[0] וגם Added recipe 4: Waffles. שלחו בקשת POST עם {"minutes":5}: הסטטוס הוא 400, ולא נרשמת ביומן שום שורה.
נסו בעצמכם
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();
כל השיעורים ביחידה Minimal APIs
4Middleware ורישום לוגים
ה-Middleware הראשון שלך