سلاسل الاستعلام
جزء من قسم واجهات 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 مطلقًا.
التحدي
سهليتعلّم GET /api/recipes التصفية: ?category=soup يُبقي على الحساء فقط.
- في
Program.cs، أضف المعاملstring? categoryإلى دالة lambda الخاصة بـGET /api/recipes. - أعِد الوصفات التي تساوي فيها
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();