Cập nhật một phần bằng PATCH
Thuộc phần REST API trong hành trình ASP.NET Core của Coddy. Bài học 4 trên 20.
PATCH chỉ thay đổi những trường mà phần thân gửi lên. Để phân biệt trường bị bỏ qua với trường được thiết lập, hãy đặt mọi thuộc tính của bản ghi patch thành nullable: trường bị thiếu sẽ liên kết với null.
record ProfilePatch(string? Name, string? City);
profiles[index] = profile with
{
Name = patch.Name ?? profile.Name,
City = patch.City ?? profile.City,
};with sao chép một bản ghi và thay đổi các thuộc tính bạn liệt kê. ?? giữ giá trị cũ khi patch chứa null. bool? cũng hoạt động tương tự: false là giá trị mà client gửi lên, còn null nghĩa là client không gửi gì. Vì vậy, { "city": "Lyon" } sẽ chuyển hồ sơ đến thành phố mới và giữ nguyên tên.
Thử thách
DễCho phép client thay đổi một trường của tác vụ, chẳng hạn đánh dấu tác vụ là đã hoàn thành, mà không cần gửi lại tiêu đề.
- Ở cuối
Program.cs, khai báorecord TaskPatch(string? Title, bool? Done); - Ánh xạ
PATCH /api/tasks/{id:int}vớiint idvàTaskPatch patch. Trả vềResults.NotFound()nếu không có tác vụ nào mang chỉ số đó. - Nếu có, lưu một bản sao của tác vụ được tạo bằng
with, trong đó mỗi thuộc tính nhận giá trị từ patch hoặc giữ nguyên giá trị của tác vụ nếu patch cónull. Trả về tác vụ đã thay đổi bằngResults.Ok.
PATCH /api/tasks/1 với { "done": true } trả về 200 và:
{ "id": 1, "title": "Write the project brief", "done": true }Thử nhé: nhấn Chạy, chọn PATCH, đường dẫn /api/tasks/1, nội dung { "done": true }, rồi nhấn Gửi: kết quả như trên, với tiêu đề được giữ nguyên. Gửi PATCH /api/tasks/2 với { "title": "Book the big room" }: tiêu đề mới được cập nhật, còn "done": true vẫn giữ nguyên. PATCH /api/tasks/99 trả về 404.
Tự làm thử
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);
Bài học này có một bài trắc nghiệm ngắn. Bắt đầu bài học để trả lời và theo dõi tiến độ.
Tất cả bài học trong REST API
1Tài nguyên và động từ
Tài nguyên và URLTạo mới bằng POST4Dự án: Mức độ ưu tiên
Mức độ ưu tiên của tác vụ