Menu
CoddyTech

ルートパラメーター

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までのコードはリクエストに誤りがあったことを意味します。

challenge icon

チャレンジ

簡単

各レシピには、それぞれ専用のアドレスがあります。/api/recipes/1、/api/recipes/2などです。

  1. Program.csで、GET /api/recipesの下にGET /api/recipes/{id}をマッピングします。
  2. そのラムダは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();

Minimal APIのすべてのレッスン