Menu
CoddyTech

Ràng buộc route

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

GET /orders/abc khớp với /orders/{number}, rồi không chuyển đổi được abc thành int: 400 Bad Request. Ràng buộc tuyến đường đặt sau dấu hai chấm sẽ giới hạn những gì một tham số có thể khớp, vì vậy đường dẫn đó không khớp với tuyến đường nào và trả về 404 Not Found.

app.MapGet("/orders/{number:int}", (int number) => $"Order {number}");
app.MapGet("/orders/{code:alpha}", (string code) => $"Code {code}");

:int khớp với số nguyên và :alpha khớp với chữ cái, vì vậy /orders/7 và /orders/abc đều khớp với một tuyến đường. Các ràng buộc khác gồm :guid, :min(1) và :length(3), và bạn có thể kết hợp chúng: {number:int:min(1)}. Ràng buộc chọn tuyến đường, chúng không kiểm tra đầu vào của người dùng, vì giá trị bị từ chối sẽ trả về 404, không phải 400.

challenge icon

Thử thách

Dễ

GET /api/recipes/abc trả về lỗi 400 về việc liên kết int id. Sẽ không bao giờ có công thức nào có địa chỉ đó, nên yêu cầu này nên trả về lỗi 404.

  1. Trong Program.cs, đổi route của endpoint từ bài học trước thành /api/recipes/{id:int}.
  2. Chỉ giữ một route cho endpoint này: sửa dòng hiện có, không thêm dòng thứ hai.

Thử nhé: nhấn Chạy: GET /api/recipes/2 vẫn trả về công thức Pancakes. Gửi GET /api/recipes/abc: trạng thái 404 và nội dung phản hồi trống. Danh sách Routes hiển thị GET /api/recipes/{id:int}.

Tự làm thử

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var recipes = new List<Recipe>
{
    new(1, "Tomato Soup", "soup", 25),
    new(2, "Pancakes", "breakfast", 15),
    new(3, "Lentil Soup", "soup", 40),
};

app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", () => recipes);
app.MapGet("/api/recipes/{id}", (int id) => recipes.FirstOrDefault(r => r.Id == id));

app.Run();
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 Minimal API