Menu
CoddyTech

التسجيل باستخدام ILogger

جزء من قسم واجهات API المصغّرة في رحلة 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>) ومعرّف الحدث.

challenge icon

التحدي

سهل

يسجّل التطبيق كل وصفة يضيفها.

  1. في Program.cs، أضف معاملًا ثانيًا إلى لامبدا POST /api/recipes، وهو ILogger<Program> logger.
  2. بعد recipes.Add(recipe); مباشرةً، استدعِ logger.LogInformation("Added recipe {Id}: {Name}", recipe.Id, recipe.Name);.

جرّب ذلك: اضغط على «تشغيل» وأرسل طلب POST إلى /api/recipes يتضمن {"name":"Waffles","category":"breakfast","minutes":20}. تعرض وحدة التحكم 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();

جميع دروس واجهات API المصغّرة