Menu
CoddyTech

سلاسل الاستعلام

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

سلسلة الاستعلام هي الجزء من العنوان الذي يأتي بعد ?: أزواج من الأسماء والقيم تفصل بينها &، كما في /books?author=austen&page=2. لا تحدد المسار؛ بل تضيف خيارات إلى الطلب. تُقرأ قيمة معامل lambda الذي لا يظهر اسمه في المسار من سلسلة الاستعلام.

app.MapGet("/books", (string? author, int page = 1) =>
    $"Books by {author ?? "anyone"}, page {page}");

يُرجع GET /books?author=austen الإجابة Books by austen, page 1. يكون المعامل اختياريًا إذا كان يقبل القيمة الفارغة، مثل string?، أو كانت له قيمة افتراضية. أما string العادي فهو مطلوب: ومن دونه، يُرجع ASP.NET Core الرمز 400 Bad Request ولا يُنفَّذ lambda مطلقًا.

challenge icon

التحدي

سهل

يتعلّم GET /api/recipes التصفية: ?category=soup يُبقي على الحساء فقط.

  1. في Program.cs، أضف المعامل string? category إلى دالة lambda الخاصة بـ GET /api/recipes.
  2. أعِد الوصفات التي تساوي فيها Category قيمة category. عندما تكون قيمة category هي null، أعِد كل الوصفات: recipes.Where(r => category is null || r.Category == category).

جرّب ذلك: اضغط على تشغيل. يعرض GET /api/recipes?category=soup وصفتي الحساء، ذواتَي المعرّفين 1 و3. أرسل GET /api/recipes: الوصفات الثلاث كلها. أرسل GET /api/recipes?category=dessert: قائمة فارغة، [].

جرّب بنفسك

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

var recipes = new List<Recipe>
{
    new(1, "Tomato Soup", "soup", 25),
    new(2, "Pancakes", "breakfast", 15),
    new(3, "Lentil Soup", "soup", 40),
};

app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", () => recipes);
app.MapGet("/api/recipes/{id:int}", (int id) => recipes.FirstOrDefault(r => r.Id == id));

app.Run();

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