Menu
CoddyTech

クエリ文字列

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を返し、ラムダは実行されません。

challenge icon

チャレンジ

簡単

GET /api/recipesにフィルター機能を追加します。?category=soupを指定すると、スープだけが残ります。

  1. Program.csで、GET /api/recipesのラムダにパラメーターstring? categoryを追加します。
  2. 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();

Minimal APIのすべてのレッスン