البحث عن الوصفات
جزء من قسم واجهات 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 ليس رقمًا، وعلى أي حال، يتقدّم النص الثابت في المسار على المعامل.
التحدي
سهليمكن للعملاء البحث عن الوصفات حسب الاسم: GET /api/recipes/search?q=soup. احتفظ بكل ما كتبته في الدروس السابقة.
- في
Program.cs، اربطGET /api/recipes/search. تأخذ دالة lambda الخاصة بهstring? q. - عندما تكون
string.IsNullOrWhiteSpace(q)، أعدResults.BadRequest(new { error = "Add ?q= to search" }). - وإلا، فأعد
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();