Menu
CoddyTech

البحث

جزء من قسم واجهات API بنمط REST في رحلة ASP.NET Core على Coddy. الدرس 11 من 20.

البحث مرشح آخر في سلسلة الاستعلام. في واجهة API لمكتبة، يعرض GET /api/books?search=potter الكتب التي يحتوي عنوانها على النص. تتراكم المرشحات: يضيّق كل مرشح نطاق النتائج التي أبقاها المرشح الذي سبقه.

if (!string.IsNullOrWhiteSpace(search))
    result = result.Where(b =>
        b.Title.Contains(search, StringComparison.OrdinalIgnoreCase));

تقارن Contains النصوص بدقة افتراضيًا، لذا لن يعثر البحث عن potter على Potter. يتجاهل StringComparison.OrdinalIgnoreCase الأحرف الكبيرة. تخطَّ المرشح عندما تكون قيمة البحث null أو فارغة: يرسل ?search= سلسلة فارغة، ويتوقع العميل الذي يمسح مربع البحث أن تظهر القائمة كاملة من جديد.

challenge icon

التحدي

سهل

دع العملاء يعثرون على المهام باستخدام كلمة من عنوانها.

  1. أضف معاملًا ثانيًا إلى لامبدا GET /api/tasks، وهو string? search.
  2. بعد عامل التصفية done، عندما لا تكون search بقيمة null أو مسافة بيضاء، احتفظ بالمهام التي يتضمن عنوانها هذه الكلمة، مع تجاهل حالة الأحرف.
  3. أبقِ عامل التصفية done: فهما يعملان معًا.

يعرض GET /api/tasks?search=ROOM المهمة 2، Book the meeting room. ويعرض GET /api/tasks?search=the&done=false المهمتين 1 و3: فجميع العناوين تحتوي على "the"، وهاتان المهمتان غير مكتملتين.

جرّب ذلك: اضغط على «تشغيل» وأرسل GET /api/tasks?search=ROOM: ستظهر المهمة 2. أرسل GET /api/tasks?search=in: ستظهر المهمتان 2 و3، بسبب كلمتي meeting وinvoice. أرسل GET /api/tasks?search=: ستظهر المهام الثلاث.

جرّب بنفسك

using System.ComponentModel.DataAnnotations;

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

app.UseExceptionHandler();
app.UseStatusCodePages();

var tasks = new List<TaskItem>
{
    new(1, "Write the project brief", false),
    new(2, "Book the meeting room", true),
    new(3, "Send the invoice", false),
};
var nextId = 4;

bool TitleTaken(string title, int exceptId) =>
    tasks.Any(t => t.Id != exceptId && string.Equals(t.Title, title, StringComparison.OrdinalIgnoreCase));

app.MapGet("/api/tasks", (bool? done) =>
{
    IEnumerable<TaskItem> result = tasks;
    if (done is not null) result = result.Where(t => t.Done == done);
    return Results.Ok(result);
});

app.MapGet("/api/tasks/{id:int}", (int id) =>
{
    var task = tasks.Find(t => t.Id == id);
    return task is null ? Results.NotFound() : Results.Ok(task);
});

app.MapPost("/api/tasks", (TaskInput input) =>
{
    var errors = Validation.Errors(input);
    if (errors is not null) return Results.ValidationProblem(errors);
    if (TitleTaken(input.Title, 0))
        return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
    var task = new TaskItem(nextId++, input.Title, input.Done);
    tasks.Add(task);
    return Results.Created($"/api/tasks/{task.Id}", task);
});

app.MapPut("/api/tasks/{id:int}", (int id, TaskInput input) =>
{
    var errors = Validation.Errors(input);
    if (errors is not null) return Results.ValidationProblem(errors);
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    if (TitleTaken(input.Title, id))
        return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
    tasks[index] = new TaskItem(id, input.Title, input.Done);
    return Results.Ok(tasks[index]);
});

app.MapPatch("/api/tasks/{id:int}", (int id, TaskPatch patch) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    if (patch.Title is not null && TitleTaken(patch.Title, id))
        return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
    var task = tasks[index];
    tasks[index] = task with
    {
        Title = patch.Title ?? task.Title,
        Done = patch.Done ?? task.Done,
    };
    return Results.Ok(tasks[index]);
});

app.MapDelete("/api/tasks/{id:int}", (int id) =>
{
    var removed = tasks.RemoveAll(t => t.Id == id);
    return removed == 0 ? Results.NotFound() : Results.NoContent();
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(
    [property: Required(ErrorMessage = "Title is required."), StringLength(80)] string Title,
    bool Done);
record TaskPatch(string? Title, bool? Done);

جميع دروس واجهات API بنمط REST