Menu
CoddyTech

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.

challenge icon

Aufgabe

Einfach

GET /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.

  1. Ändere in Program.cs die Route des Endpunkts aus der letzten Lektion zu /api/recipes/{id:int}.
  2. 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();
quiz iconTeste dich selbst

Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.

Alle Lektionen in Minimal APIs