Menu
CoddyTech

רישום לוגים עבור כל בקשה

חלק מהיחידה Minimal APIs במסלול ה-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

אתגר

קל

המסוף מציג שורה אחת לכל בקשה, למשל 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, והמסוף מציג 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();

כל השיעורים ביחידה Minimal APIs