Từ chối đầu vào không hợp lệ
Thuộc phần REST API trong hành trình ASP.NET Core của Coddy. Bài học 6 trên 20.
Phần thân request có thể liên kết được nhưng vẫn không hợp lý: email trống, giá âm. Hãy trả về 400 Bad Request và cho biết vấn đề theo định dạng mà client có thể đọc. Results.ValidationProblem nhận một từ điển ánh xạ tên trường với các thông báo:
if (string.IsNullOrWhiteSpace(input.Email))
{
return Results.ValidationProblem(new Dictionary<string, string[]>
{
["email"] = ["Email is required."],
});
}Kết quả trả về có mã 400, kiểu nội dung application/problem+json và phần thân sau:
{ "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"errors": { "email": ["Email is required."] } }Hãy kiểm tra trước khi thay đổi bất cứ thứ gì để yêu cầu bị từ chối không làm thay đổi dữ liệu. Phần thân không phải JSON hợp lệ sẽ không đến được hàm lambda của bạn: ASP.NET Core sẽ trả về mã 400.
Thử thách
DễHiện tại, POST /api/tasks với { "title": "" } vẫn thêm một tác vụ không có tiêu đề. Hãy từ chối yêu cầu đó.
- Ở đầu lambda
POST /api/tasks, trướcnextId++, hãy kiểm tra tiêu đề bằngstring.IsNullOrWhiteSpace(input.Title). Cách này phát hiện tiêu đề bị thiếu (null), để trống hoặc chỉ chứa khoảng trắng. - Nếu kiểm tra thất bại, hãy trả về
Results.ValidationProblemvới trườngtitlevà thông báoTitle is required., để phần thân phản hồi có nội dung:"errors": { "title": ["Title is required."] } - Thêm bước kiểm tra tương tự ở đầu lambda
PUT /api/tasks/{id:int}.
Thử nhé: nhấn Chạy rồi gửi POST { "title": "" } đến /api/tasks: nhận 400 cùng các lỗi ở trên. Gửi GET /api/tasks: vẫn có ba tác vụ. Gửi PUT { "title": " ", "done": true } đến /api/tasks/1: nhận 400 và tác vụ 1 vẫn giữ nguyên tiêu đề. Gửi POST { "title": "Order new chairs" }: nhận 201 với id 4.
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.MapPatch("/api/tasks/{id:int}", (int id, TaskPatch patch) =>
{
var index = tasks.FindIndex(t => t.Id == id);
if (index == -1) return Results.NotFound();
var task = tasks[index];
tasks[index] = task with
{
Title = patch.Title ?? task.Title,
Done = patch.Done ?? task.Done,
};
return Results.Ok(tasks[index]);
});
app.MapDelete("/api/tasks/{id:int}", (int id) =>
{
var removed = tasks.RemoveAll(t => t.Id == id);
return removed == 0 ? Results.NotFound() : Results.NoContent();
});
app.Run();
record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
record TaskPatch(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ụ