クエリ文字列
CoddyのASP.NET Coreジャーニー「Minimal API」セクションの一部。レッスン 5/20。
クエリ文字列は、アドレスの?より後ろの部分です。&でつながれた名前と値のペアで構成され、たとえば/books?author=austen&page=2のようになります。クエリ文字列はルートを選択するものではなく、リクエストにオプションを追加します。名前がルートに含まれていないラムダパラメーターは、クエリ文字列から読み取られます。
app.MapGet("/books", (string? author, int page = 1) =>
$"Books by {author ?? "anyone"}, page {page}");GET /books?author=austenはBooks by austen, page 1を返します。string?のようにnull許容のパラメーター、またはデフォルト値を持つパラメーターは省略可能です。通常のstringは必須です。これを指定しない場合、ASP.NET Coreは400 Bad Requestを返し、ラムダは実行されません。
チャレンジ
簡単GET /api/recipesにフィルター機能を追加します。?category=soupを指定すると、スープだけが残ります。
Program.csで、GET /api/recipesのラムダにパラメーターstring? categoryを追加します。Categoryがcategoryと等しいレシピを返します。categoryがnullの場合は、すべてのレシピを返します:recipes.Where(r => category is null || r.Category == category)。
試してみましょう:「実行」を押します。GET /api/recipes?category=soupを送信すると、スープ2件(id 1と3)が返ります。GET /api/recipesを送信すると、レシピ3件すべてが返ります。GET /api/recipes?category=dessertを送信すると、空のリスト[]が返ります。
自分で試してみよう
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}", (int id) => recipes.FirstOrDefault(r => r.Id == id));
app.Run();