Menu
CoddyTech

ملخصات التقييمات

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

أخيرًا، تحصل كل وصفة على ملخص لتقييماتها. تُرجع Average في LINQ قيمة من النوع double وتُطلق InvalidOperationException عند التعامل مع تسلسل فارغ، لذا تحقّق من العدد أولًا. تحتفظ Math.Round(value, 1) بمنزلة عشرية واحدة: Math.Round(4.333, 1) تساوي 4.3.

var scores = results.Where(r => r.Team == team).Select(r => r.Score).ToList();
var mean = scores.Count == 0 ? 0 : Math.Round(scores.Average(), 1);
return Results.Ok(new { count = scores.Count, mean });

تُسمّي new { mean } الخاصية باسم المتغير، لذا تكون النتيجة {"count":3,"mean":7.5}.

challenge icon

التحدي

سهل

تجيب GET /api/recipes/2/ratings عن عدد تقييمات الوصفة 2 ومتوسطها. احتفظ بكل ما كتبته في الدروس السابقة.

  1. في Program.cs، أضف إلى مجموعة التقييمات مسار GET يأخذ int id.
  2. إذا لم تكن هناك وصفة بهذا المعرّف، فأعِد Results.NotFound(new { error = $"Recipe {id} not found" }).
  3. استخرج عدد النجوم من التقييمات التي يكون فيها RecipeId مساويًا لـ id. يكون المتوسط 0 عندما لا توجد تقييمات؛ وإلا فاحسب متوسطها وقرّبه إلى منزلة عشرية واحدة.
  4. أعِد Results.Ok(new { count = stars.Count, average }).

جرّب ذلك: اضغط على «تشغيل». يجيب GET /api/recipes/2/ratings بـ {"count":0,"average":0}. أرسل POST مع {"stars":4} و{"stars":5} إلى /api/recipes/2/ratings، ثم أرسل طلب GET مرة أخرى: {"count":2,"average":4.5}. أضف تقييمًا ثالثًا بقيمة 4: يصبح المتوسط 4.3. يجيب GET /api/recipes/99/ratings بالرمز 404.

جرّب بنفسك

using Microsoft.AspNetCore.Http.HttpResults;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Use(async (context, next) =>
{
    await next();
    app.Logger.LogInformation("{Method} {Path} -> {Status}",
        context.Request.Method, context.Request.Path, context.Response.StatusCode);
});

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>();
var ratings = new List<Rating>();

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/search", (string? q) =>
{
    if (string.IsNullOrWhiteSpace(q))
        return Results.BadRequest(new { error = "Add ?q= to search" });
    return Results.Ok(recipes.Where(r => r.Name.Contains(q, StringComparison.OrdinalIgnoreCase)));
});
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();
});

var recipeRatings = app.MapGroup("/api/recipes/{id:int}/ratings");
recipeRatings.MapPost("/", (int id, NewRating input) =>
{
    if (!recipes.Any(r => r.Id == id))
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    if (input.Stars < 1 || input.Stars > 5)
        return Results.BadRequest(new { error = "Stars must be from 1 to 5" });
    var rating = new Rating(id, input.Stars);
    ratings.Add(rating);
    return Results.Created($"/api/recipes/{id}/ratings", rating);
});

app.Run();

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