Menu
CoddyTech

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.

challenge icon

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 đề.

  1. Ở cuối Program.cs, khai báo record TaskPatch(string? Title, bool? Done);
  2. Ánh xạ PATCH /api/tasks/{id:int} với int id và TaskPatch patch. Trả về Results.NotFound() nếu không có tác vụ nào mang chỉ số đó.
  3. 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ằng Results.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);
quiz iconTự kiểm tra

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