ルートパラメーター
CoddyのASP.NET Coreジャーニー「Minimal API」セクションの一部。レッスン 3/20。
レシピごとにルートを用意していては、終わりがありません。ルートパラメーターは、波かっこで囲まれたパスの一部で、その位置にある任意の値に一致します。
app.MapGet("/orders/{number}", (int number) => $"Order {number}");GET /orders/42はOrder 42を返します。ASP.NET Coreは、値を同じ名前のラムダパラメーターに渡し、テキスト42をパラメーターの型(ここではint)に変換します。ルートに含まれていない名前のパラメーターは、代わりにクエリ文字列から探されます。そこにもない場合、応答は400 Bad Requestになります。ステータスコードは、すべての応答の先頭にある数値です。200はOKを意味し、400から499までのコードはリクエストに誤りがあったことを意味します。
チャレンジ
簡単各レシピには、それぞれ専用のアドレスがあります。/api/recipes/1、/api/recipes/2などです。
Program.csで、GET /api/recipesの下にGET /api/recipes/{id}をマッピングします。- そのラムダは
int idを受け取り、Idがidと等しいレシピを返します。recipes.FirstOrDefault(r => r.Id == id)で見つけます。
試してみましょう:「実行」を押します。GET /api/recipes/2の応答は{"id":2,"name":"Pancakes","category":"breakfast","minutes":15}です。GET /api/recipes/99を送信します。そのIDのレシピはないため、FirstOrDefaultはnullを返し、応答はステータス200で、本文はnullです。次の章では、この場合に404を返す方法を説明します。
自分で試してみよう
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.Run();