مستويات التسجيل
جزء من قسم واجهات API المصغّرة في رحلة ASP.NET Core على Coddy. الدرس 16 من 20.
يحتوي كل سطر سجل على مستوى. من الأدنى إلى الأعلى: Trace وDebug وInformation وWarning وError وCritical، وتُكتب باستخدام LogTrace حتى LogCritical. تحدد الإعدادات أدنى مستوى يُحتفظ به لكل فئة. يحتوي ملف appsettings.json في مشروع ASP.NET Core جديد على:
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
}
}لذا تُسقط أسطر LogDebug، وكذلك أسطر Information الخاصة بـ ASP.NET Core، بينما تبقى تحذيراته. لا يحتوي مشروعك على appsettings.json؛ ويطبّق تشغيل المستويات نفسها. يُستخدم Warning لشيء غير معتاد لم يتسبب في تعطّل التطبيق، مثل طلب وصفة غير موجودة.
التحدي
سهليُسجَّل الطلب للحصول على وصفة غير موجودة كتحذير.
- في
Program.cs، أضِف معاملًا ثانيًا إلى دالةGET /api/recipes/{id:int}المجهولة، وهوILogger<Program> logger. - داخل
if (recipe is null)، وقبلreturn، استدعِlogger.LogWarning("Recipe {Id} was not found", id);. أصبحifينفّذ تعليمتين الآن، لذا أضِف إليه أقواسًا.
جرّب ذلك: اضغط على «تشغيل». يُرجع الطلب الأول، GET /api/recipes/99، الرمز 404 كما في السابق، وتعرض وحدة التحكم warn: Program[0] وRecipe 99 was not found. أرسل GET /api/recipes/2: الرمز 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) =>
{
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, 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 المصغّرة
4البرمجيات الوسيطة والتسجيل
أول Middleware لك