تسجيل كل طلب
جزء من قسم واجهات 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. كما أن موضعها مهم. فالبرمجية الوسيطة التي تُضاف أولًا تستقبل كل طلب، بما في ذلك الطلبات التي تنهيها برمجية وسيطة لاحقة مبكرًا، وهي آخر ما يُنفَّذ أثناء العودة.
التحدي
سهليعرض Console سطرًا واحدًا لكل طلب، مثل GET /api/recipes/2 -> 200.
- في
Program.cs، أضف برمجية وسيطة مباشرةً بعدvar app = builder.Build();، وفوق البرمجية الوسيطةX-Api-Version. - تستدعي أولًا
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 المصغّرة
4البرمجيات الوسيطة والتسجيل
أول Middleware لك