Menu
CoddyTech

Pencarian

Termasuk bagian REST API dalam perjalanan ASP.NET Core di Coddy. Pelajaran 11 dari 20.

Pencarian adalah filter lain dalam query string. Dalam API library, GET /api/books?search=potter mengembalikan buku yang judulnya memuat teks tersebut. Filter diterapkan secara berurutan: setiap filter mempersempit hasil yang tersisa dari filter sebelumnya.

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

Contains secara default membandingkan dengan tepat, jadi Potter tidak akan cocok dengan pencarian potter. StringComparison.OrdinalIgnoreCase mengabaikan huruf kapital. Lewati filter jika pencarian bernilai null atau kosong: ?search= mengirim string kosong, dan client yang menghapus isi kotak pencariannya mengharapkan seluruh daftar ditampilkan kembali.

challenge icon

Tantangan

Mudah

Biarkan client menemukan task berdasarkan kata dalam judulnya.

  1. Beri lambda GET /api/tasks parameter kedua, string? search.
  2. Setelah filter done, jika search tidak null atau spasi kosong, pertahankan task yang judulnya memuat kata tersebut, tanpa membedakan huruf besar dan kecil.
  3. Pertahankan filter done: keduanya bekerja bersama.

GET /api/tasks?search=ROOM menampilkan task 2, Book the meeting room. GET /api/tasks?search=the&done=false menampilkan task 1 dan 3: setiap judul memiliki "the", dan kedua task tersebut belum selesai.

Coba: tekan Jalankan dan kirim GET /api/tasks?search=ROOM: task 2. Kirim GET /api/tasks?search=in: task 2 dan 3, untuk meeting dan invoice. Kirim GET /api/tasks?search=: ketiganya.

Coba sendiri

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);

Semua pelajaran di REST API