Menu
CoddyTech

البحث عن الوصفات

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

يضيف هذا الفصل ثلاث ميزات إلى واجهة API للوصفات، وكل ميزة مبنية على ما علّمه هذا القسم. أولًا، البحث. تبحث string.Contains عن نص داخل نص، وهي تراعي حالة الأحرف: تكون نتيجة "Pancakes".Contains("pan") هي false. أما StringComparison.OrdinalIgnoreCase فتتجاهل حالة الأحرف:

var hits = books.Where(b => b.Title.Contains(term, StringComparison.OrdinalIgnoreCase));

لا يتعارض /api/recipes/search مع /api/recipes/{id:int}: فـ search ليس رقمًا، وعلى أي حال، يتقدّم النص الثابت في المسار على المعامل.

challenge icon

التحدي

سهل

يمكن للعملاء البحث عن الوصفات حسب الاسم: GET /api/recipes/search?q=soup. احتفظ بكل ما كتبته في الدروس السابقة.

  1. في Program.cs، اربط GET /api/recipes/search. تأخذ دالة lambda الخاصة به string? q.
  2. عندما تكون string.IsNullOrWhiteSpace(q)، أعد Results.BadRequest(new { error = "Add ?q= to search" }).
  3. وإلا، فأعد Results.Ok(...) مع الوصفات التي يحتوي Name فيها على q، مع تجاهل حالة الأحرف، وبترتيب recipes.

جرّب ذلك: اضغط على «تشغيل». يعيد GET /api/recipes/search?q=soup الوصفتين Tomato Soup وLentil Soup. أرسل ?q=PAN: فتظهر Pancakes. أرسل ?q=pizza: فتظهر []. أرسل GET /api/recipes/search من دون استعلام: تكون الحالة 400 ويظهر {"error":"Add ?q= to search"}.

جرّب بنفسك

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>();

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 المصغّرة