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.
Tantangan
MudahBiarkan client mengubah satu field pada task, seperti menandainya sebagai selesai, tanpa mengirim ulang judulnya.
- Di bagian bawah
Program.cs, deklarasikanrecord TaskPatch(string? Title, bool? Done); - Petakan
PATCH /api/tasks/{id:int}denganint iddanTaskPatch patch. Berikan jawabanResults.NotFound()saat tidak ada task dengan id tersebut. - Jika ada, simpan salinan task yang dibuat dengan
with, dengan setiap property mengambil nilai dari patch, atau mempertahankan nilai milik task jika patch berisinull. Berikan jawaban berupa task yang telah diubah denganResults.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);
Pelajaran ini berisi kuis singkat. Mulai pelajarannya untuk menjawab kuis dan melacak progresmu.
Semua pelajaran di REST API
1Sumber Daya dan Kata Kerja
Sumber Daya dan URLMembuat dengan POST