Tạo mới bằng POST
Thuộc phần REST API trong hành trình ASP.NET Core của Coddy. Bài học 2 trên 20.
POST thêm một mục vào bộ sưu tập. Yêu cầu được gửi đến URL của bộ sưu tập vì client không biết id mới: máy chủ sẽ chọn id đó. Phản hồi là 201 Created, kèm mục mới dưới dạng JSON và một header Location chứa URL của mục mới. Header là một dòng văn bản có tên, được gửi trước phần nội dung.
var nextId = 8;
app.MapPost("/api/books", (BookInput input) =>
{
var book = new Book(nextId++, input.Title, input.Author);
books.Add(book);
return Results.Created($"/api/books/{book.Id}", book);
});Tham số bản ghi được đọc từ phần nội dung JSON, còn thuộc tính bị thiếu sẽ nhận giá trị mặc định của kiểu dữ liệu đó. Bộ đếm gán id cho từng cuốn sách. Đừng tạo id bằng Random hoặc đồng hồ: cùng một yêu cầu phải luôn tạo ra cùng một id. Ở đây, điều đó càng quan trọng vì mỗi lần nhấn Gửi sẽ phát lại các yêu cầu trước đó trên một ứng dụng mới.
Thử thách
DễCho phép client thêm công việc.
- Trong
Program.cs, bên dưới danh sách công việc, thêm một bộ đếm:var nextId = 4; - Ở cuối tệp, bên dưới
TaskItem, khai báo cấu trúc phần thân:record TaskInput(string Title, bool Done); - Ánh xạ
POST /api/tasksvới tham sốTaskInput input. Tạo mộtTaskItemtừnextId++,input.Titlevàinput.Done, thêm nó vàotasks, rồi trả lời bằngResults.Created($"/api/tasks/{task.Id}", task).
Phần thân { "title": "Order new chairs" } trả về 201 cùng tiêu đề Location: /api/tasks/4 và:
{ "id": 4, "title": "Order new chairs", "done": false }Thử nhé: nhấn Chạy, chọn POST, giữ nguyên đường dẫn /api/tasks, nhập phần thân ở trên rồi nhấn Gửi: 201, và thẻ Headers hiển thị Location: /api/tasks/4. Gửi GET /api/tasks/4: công việc mới. Gửi lại cùng POST: lần này công việc có id 5, vì cột này phát lại POST đầu tiên trước nó.
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),
};
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.Run();
record TaskItem(int Id, string Title, bool Done);
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ụ