Menu
CoddyTech

Memperbarui Sebagian dengan PATCH

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

PATCH hanya mengubah field yang dikirim oleh body. Untuk membedakan field yang tidak disertakan dari field yang nilainya ditetapkan, buat setiap property pada record patch nullable: field yang tidak ada akan terikat ke null.

record ProfilePatch(string? Name, string? City);

profiles[index] = profile with
{
    Name = patch.Name ?? profile.Name,
    City = patch.City ?? profile.City,
};

with menyalin record dan mengubah property yang kamu cantumkan. ?? mempertahankan nilai lama saat patch berisi null. bool? bekerja dengan cara yang sama: false adalah nilai yang dikirim klien, dan null berarti klien tidak mengirim apa pun. Jadi, { "city": "Lyon" } memindahkan profil dan mempertahankan namanya.

challenge icon

Tantangan

Mudah

Biarkan client mengubah satu field pada task, seperti menandainya sebagai selesai, tanpa mengirim ulang judulnya.

  1. Di bagian bawah Program.cs, deklarasikan record TaskPatch(string? Title, bool? Done);
  2. Petakan PATCH /api/tasks/{id:int} dengan int id dan TaskPatch patch. Berikan jawaban Results.NotFound() saat tidak ada task dengan id tersebut.
  3. Jika ada, simpan salinan task yang dibuat dengan with, dengan setiap property mengambil nilai dari patch, atau mempertahankan nilai milik task jika patch berisi null. Berikan jawaban berupa task yang telah diubah dengan Results.Ok.

PATCH /api/tasks/1 dengan { "done": true } memberikan jawaban 200 dan:

{ "id": 1, "title": "Write the project brief", "done": true }

Coba: tekan Jalankan, pilih PATCH, path /api/tasks/1, isi body dengan { "done": true }, lalu tekan Kirim: jawabannya seperti di atas, dengan judul tetap. Kirim PATCH /api/tasks/2 dengan { "title": "Book the big room" }: judulnya berubah, dan "done": true tetap. PATCH /api/tasks/99 memberikan jawaban 404.

Coba sendiri

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

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;

app.MapGet("/api/tasks", () => tasks);

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 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 index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    tasks[index] = new TaskItem(id, input.Title, input.Done);
    return Results.Ok(tasks[index]);
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
quiz iconUji dirimu

Pelajaran ini berisi kuis singkat. Mulai pelajarannya untuk menjawab kuis dan melacak progresmu.

Semua pelajaran di REST API