Menu
CoddyTech

تسجيل كل طلب

جزء من قسم واجهات API المصغّرة في رحلة ASP.NET Core على Coddy. الدرس 17 من 20.

يمكن للبرمجية الوسيطة مراقبة ما يجيب به التطبيق. إن app.Logger مسجّل يملكه التطبيق بالفعل، لاستخدامه في الشيفرة خارج نقاط النهاية. هذا المسجّل يصدر تحذيرًا بشأن الطلبات التي لم تعثر على شيء:

app.Use(async (context, next) =>
{
    await next();
    if (context.Response.StatusCode == 404)
        app.Logger.LogWarning("Nothing at {Path}", context.Request.Path);
});

يقرأ رمز الحالة بعد await next()، أثناء العودة، عندما تكون نقطة نهاية أو برمجية وسيطة لاحقة قد ضبطته؛ أما قبل next() فيظل رمز الحالة 200. كما أن موضعها مهم. فالبرمجية الوسيطة التي تُضاف أولًا تستقبل كل طلب، بما في ذلك الطلبات التي تنهيها برمجية وسيطة لاحقة مبكرًا، وهي آخر ما يُنفَّذ أثناء العودة.

challenge icon

التحدي

سهل

يعرض Console سطرًا واحدًا لكل طلب، مثل GET /api/recipes/2 -> 200.

  1. في Program.cs، أضف برمجية وسيطة مباشرةً بعد var app = builder.Build();، وفوق البرمجية الوسيطة X-Api-Version.
  2. تستدعي أولًا await next();، ثم app.Logger.LogInformation("{Method} {Path} -> {Status}", context.Request.Method, context.Request.Path, context.Response.StatusCode);.

جرّب ذلك: اضغط على «تشغيل». الطلب الأول هو GET /recipes/2، ويعرض Console GET /recipes/2 -> 301. أرسل GET /api/recipes/99: سيظهر التحذير من الدرس السابق، ثم GET /api/recipes/99 -> 404. أرسل GET /index.html: GET /index.html -> 200.

جرّب بنفسك

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, ILogger<Program> logger) =>
{
    var recipe = recipes.FirstOrDefault(r => r.Id == id);
    if (recipe is null)
    {
        logger.LogWarning("Recipe {Id} was not found", id);
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    }
    return Results.Ok(recipe);
});

app.MapPost("/api/recipes", (NewRecipe input, ILogger<Program> logger) =>
{
    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);
    logger.LogInformation("Added recipe {Id}: {Name}", recipe.Id, recipe.Name);
    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 المصغّرة