ルート制約
CoddyのASP.NET Coreジャーニー「Minimal API」セクションの一部。レッスン 4/20。
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 はそれぞれ1つのルートに到達します。ほかには :guid、:min(1)、:length(3) があり、連結して指定できます:{number:int:min(1)}。制約はルートを選択するもので、ユーザーの入力を検証するものではありません。拒否された値に対して返されるのは400ではなく404だからです。
チャレンジ
簡単GET /api/recipes/abc は、int id のバインドに関するエラーとともに 400 を返します。そのアドレスのレシピは存在しないため、404 を返すべきです。
Program.csで、前のレッスンのエンドポイントのルートを/api/recipes/{id:int}に変更します。- このエンドポイントのルートは1つのままにします。2つ目を追加せず、既存の行を変更してください。
試してみましょう: 「実行」を押します。GET /api/recipes/2 は引き続き Pancakes のレシピを返します。GET /api/recipes/abc を送信すると、ステータスは 404 で、本文は空になります。ルート一覧には 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();
このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。