Menu
CoddyTech

Thay thế bằng PUT

Thuộc phần REST API trong hành trình ASP.NET Core của Coddy. Bài học 3 trên 20.

PUT thay thế một mục. Phần thân là trạng thái mới hoàn chỉnh của mục đó, được gửi đến URL riêng của mục, và trường nào không có trong phần thân sẽ nhận giá trị mặc định. Gửi cùng một yêu cầu PUT hai lần sẽ cho kết quả như nhau, vì vậy PUT có tính lũy đẳng (idempotent): máy khách có thể thử lại sau khi hết thời gian chờ. POST thì không như vậy, vì lần POST thứ hai sẽ thêm một mục thứ hai.

app.MapPut("/api/products/{id:int}", (int id, ProductInput input) =>
{
    var index = products.FindIndex(p => p.Id == id);
    if (index == -1) return Results.NotFound();
    products[index] = new Product(id, input.Name, input.Price);
    return Results.Ok(products[index]);
});

id lấy từ đường dẫn, không bao giờ lấy từ phần thân, vì vậy máy khách không thể chuyển sản phẩm sang id khác. FindIndex trả về vị trí của mục trong danh sách hoặc -1 nếu không có mục nào khớp, còn products[index] = ... lưu phiên bản mới vào vị trí đó.

challenge icon

Thử thách

Dễ

Cho phép máy khách thay thế một tác vụ.

  1. Trong Program.cs, ánh xạ PUT /api/tasks/{id:int} với tham số int id và TaskInput input. Phần nội dung có cấu trúc giống phần nội dung của yêu cầu POST.
  2. Tìm vị trí của tác vụ bằng tasks.FindIndex. Nếu kết quả là -1, trả về Results.NotFound() và không thêm gì cả.
  3. Nếu không, lưu new TaskItem(id, input.Title, input.Done) tại vị trí đó rồi trả về kết quả bằng Results.Ok. PUT /api/tasks/1 với { "title": "Write the final brief", "done": true } trả về 200 và:
    { "id": 1, "title": "Write the final brief", "done": true }

Thử nhé: nhấn Chạy, chọn PUT, đường dẫn /api/tasks/1, nhập phần nội dung ở trên rồi nhấn Gửi: nhận được 200 và tác vụ ở trên. Gửi yêu cầu GET /api/tasks/1: tiêu đề mới sẽ xuất hiện. Gửi yêu cầu PUT đến /api/tasks/2 với { "title": "Book the big room" }: tác vụ 2 đã hoàn thành, nhưng phần nội dung không có done, nên kết quả trả về là "done": false. Yêu cầu PUT đến /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.Run();

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

Tất cả bài học trong REST API