Menu
CoddyTech

路由参数

本课属于 Coddy ASP.NET Core 学习旅程的“Minimal APIs”单元。第 3 课,共 20 课。

每种配方都单独设置一条路由的话,路由会没完没了。路由参数是路径中用大括号括起来的一部分,它会匹配该位置上的任意值。

app.MapGet("/orders/{number}", (int number) => $"Order {number}");

GET /orders/42会返回Order 42。ASP.NET Core 会将这个值传给同名的 lambda 参数,并将文本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. 它的 lambda 接收 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 APIs中的所有课