OK und Nicht gefunden
Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 6 von 20.
Ein Endpunkt, der auf mehr als eine Weise antworten kann, gibt ein Ergebnis aus Results zurück, das den Statuscode festlegt. Results.Ok(value) entspricht dem Statuscode 200 und gibt den Wert als JSON zurück, und Results.NotFound() entspricht dem Statuscode 404 „Nicht gefunden“, dem Code für etwas, das nicht existiert.
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);
});Jedes return läuft über Results, sodass sie denselben Typ IResult haben und der Lambda-Ausdruck kompiliert. new { error = "No such book" } ist ein anonymes Objekt: ASP.NET Core schreibt es als {"error":"No such book"}, einen Antwortinhalt, der dem Client mitteilt, was schiefgelaufen ist.
Aufgabe
EinfachGET /api/recipes/99 antwortet mit 200 und null. Ein Client kann das nicht von einem vorhandenen Rezept unterscheiden, daher sollte die Antwort 404 lauten.
- Gib in
Program.csder Lambda-Funktion fürGET /api/recipes/{id:int}einen Blockkörper,{ ... }, der das Rezept mitFirstOrDefaultfindet. - Wenn es
nullist, gibResults.NotFound(new { error = $"Recipe {id} not found" })zurück. Für die ID 99 lautet der Antwortinhalt{"error":"Recipe 99 not found"}. - Gib andernfalls
Results.Ok(recipe)zurück.
Probier es aus: Drücke auf „Ausführen“. GET /api/recipes/99 antwortet mit Status 404 und {"error":"Recipe 99 not found"}. Sende GET /api/recipes/2: Status 200 und das Pancakes-Rezept, wie zuvor.
Probier es selbst
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();
Alle Lektionen in Minimal APIs
1Erste Endpoints
Dein erster EndpointJSON zurückgeben4Middleware und Protokollierung
Deine erste Middleware2Ergebnisse und JSON-Bodies
OK und Nicht gefunden