Routenbeschränkungen
Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 4 von 20.
GET /orders/abc passt auf /orders/{number}, lässt sich dann aber nicht in einen int umwandeln: 400 Ungültige Anfrage. Eine Routeneinschränkung nach einem Doppelpunkt begrenzt, worauf ein Parameter passt. Dadurch passt der Pfad auf keine Route und liefert 404 Nicht gefunden.
app.MapGet("/orders/{number:int}", (int number) => $"Order {number}");
app.MapGet("/orders/{code:alpha}", (string code) => $"Code {code}");:int passt auf ganze Zahlen und :alpha auf Buchstaben. Daher erreicht /orders/7 jeweils eine Route, ebenso wie /orders/abc. Weitere Einschränkungen sind :guid, :min(1) und :length(3). Sie lassen sich kombinieren: {number:int:min(1)}. Einschränkungen wählen eine Route aus; sie überprüfen nicht die Eingabe eines Benutzers, denn ein abgelehnter Wert liefert 404 statt 400.
Aufgabe
EinfachGET /api/recipes/abc antwortet mit 400 und einem Fehler bezüglich der Bindung von int id. Kein Rezept wird jemals diese Adresse haben, daher sollte mit 404 geantwortet werden.
- Ändere in
Program.csdie Route des Endpunkts aus der letzten Lektion zu/api/recipes/{id:int}. - Behalte eine Route dafür bei: Ändere die vorhandene Zeile und füge keine zweite hinzu.
Probiere es aus: Drücke „Ausführen“: GET /api/recipes/2 gibt weiterhin das Rezept Pancakes zurück. Sende GET /api/recipes/abc: Status 404 und ein leerer Body. Die Routenliste zeigt GET /api/recipes/{id:int}.
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", () => recipes);
app.MapGet("/api/recipes/{id}", (int id) => recipes.FirstOrDefault(r => r.Id == id));
app.Run();
Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.
Alle Lektionen in Minimal APIs
1Erste Endpoints
Dein erster EndpointJSON zurückgeben4Middleware und Protokollierung
Deine erste Middleware2Ergebnisse und JSON-Bodies
OK und Nicht gefunden