Menu
CoddyTech

成功和未找到

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

可以用多种方式响应的端点会返回 Results 中的结果,由它设置状态码。Results.Ok(value) 表示状态码为 200,并将该值作为 JSON 返回;Results.NotFound() 表示 404 Not Found,这是表示某个内容不存在的状态码。

app.MapGet("/books/{id:int}", (int id) =>
{
    var book = books.FirstOrDefault(b => b.Id == id);
    if (book is null)
        return Results.NotFound(new { error = "No such book" });
    return Results.Ok(book);
});

每个 return 都会通过 Results 返回,因此它们具有相同的类型 IResult,lambda 可以通过编译。new { error = "No such book" } 是一个匿名对象:ASP.NET Core 会将它写成 {"error":"No such book"},作为响应正文告知客户端出了什么问题。

challenge icon

挑战

简单

GET /api/recipes/99会返回状态码 200 和 null。客户端无法区分这种情况和食谱存在的情况,所以应该返回状态码 404。

  1. 在 Program.cs 中,为 GET /api/recipes/{id:int} 的 lambda 添加块体 { ... },并使用 FirstOrDefault 查找食谱。
  2. 如果结果为 null,则返回 Results.NotFound(new { error = $"Recipe {id} not found" })。对于 id 99,响应正文为 {"error":"Recipe 99 not found"}。
  3. 否则,返回 Results.Ok(recipe)。

试试看:按下“运行”。GET /api/recipes/99会返回状态码 404 和 {"error":"Recipe 99 not found"}。发送 GET /api/recipes/2,状态码为 200,并返回 Pancakes 食谱,和之前一样。

亲手试试

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", (string? category) =>
    recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) => recipes.FirstOrDefault(r => r.Id == id));

app.Run();

Minimal APIs中的所有课