Menu
CoddyTech

ルート制約

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だからです。

challenge icon

チャレンジ

簡単

GET /api/recipes/abc は、int id のバインドに関するエラーとともに 400 を返します。そのアドレスのレシピは存在しないため、404 を返すべきです。

  1. Program.cs で、前のレッスンのエンドポイントのルートを /api/recipes/{id:int} に変更します。
  2. このエンドポイントのルートは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();
quiz icon腕試し

このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。

Minimal APIのすべてのレッスン