Menu
CoddyTech

חיפוש

חלק מהיחידה REST APIs במסלול ה-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);

כל השיעורים ביחידה REST APIs