Menu
CoddyTech

라우트 제약 조건

Coddy ASP.NET Core 여정의 Minimal API 섹션에 포함된 레슨. 20개 중 4번째.

GET /orders/abc는 /orders/{number}와 일치한 다음, abc를 int로 변환하지 못합니다. 결과는 400 Bad Request입니다. 콜론 뒤에 오는 라우트 제약 조건은 매개변수가 일치할 수 있는 값을 제한하므로, 해당 경로는 어떤 라우트와도 일치하지 않아 404 Not Found를 반환합니다.

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

:int는 정수를, :alpha는 문자를 일치시키므로 /orders/7과 /orders/abc는 각각 하나의 라우트에 도달합니다. 그 밖에 :guid, :min(1), :length(3)도 있으며, 이들을 연결할 수도 있습니다. 예: {number:int:min(1)}. 제약 조건은 라우트를 선택하며 사용자의 입력을 검사하지 않습니다. 거부된 값에 대해 400이 아니라 404를 반환하기 때문입니다.

challenge icon

챌린지

쉬움

GET /api/recipes/abc는 int id 바인딩에 관한 오류와 함께 400을 반환합니다. 그런 주소를 가진 레시피는 있을 수 없으므로 404를 반환해야 합니다.

  1. Program.cs에서 이전 수업의 엔드포인트 경로를 /api/recipes/{id:int}로 변경하세요.
  2. 이 엔드포인트의 경로는 하나만 유지하세요. 기존 줄을 변경하고 두 번째 경로를 추가하지 마세요.

시험해 보세요: 실행을 누르세요. GET /api/recipes/2는 여전히 Pancakes 레시피를 반환합니다. GET /api/recipes/abc를 보내세요. 상태 코드는 404이고 본문은 비어 있습니다. Routes 목록에는 GET /api/recipes/{id:int}가 표시됩니다.

직접 해보기

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 icon실력 점검

이 레슨에는 짧은 퀴즈가 포함되어 있습니다. 레슨을 시작해 문제를 풀고 진행 상황을 기록하세요.

Minimal API의 모든 레슨