成功和未找到
本课属于 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"},作为响应正文告知客户端出了什么问题。
挑战
简单GET /api/recipes/99会返回状态码 200 和 null。客户端无法区分这种情况和食谱存在的情况,所以应该返回状态码 404。
- 在
Program.cs中,为GET /api/recipes/{id:int}的 lambda 添加块体{ ... },并使用FirstOrDefault查找食谱。 - 如果结果为
null,则返回Results.NotFound(new { error = $"Recipe {id} not found" })。对于 id 99,响应正文为{"error":"Recipe 99 not found"}。 - 否则,返回
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();