Contraintes de route
Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 4 sur 20.
GET /orders/abc correspond à /orders/{number}, puis échoue à convertir abc en int : 400 Bad Request. Une contrainte de routage placée après deux-points limite les valeurs auxquelles un paramètre correspond ; ce chemin ne correspond donc à aucune route et renvoie 404 Not Found.
app.MapGet("/orders/{number:int}", (int number) => $"Order {number}");
app.MapGet("/orders/{code:alpha}", (string code) => $"Code {code}");:int correspond aux nombres entiers et :alpha aux lettres ; /orders/7 et /orders/abc atteignent donc chacun une route. Il existe également :guid, :min(1) et :length(3), qui peuvent être combinés : {number:int:min(1)}. Les contraintes choisissent une route ; elles ne vérifient pas la saisie de l'utilisateur, car une valeur refusée renvoie 404, et non 400.
Défi
FacileGET /api/recipes/abc répond 400 avec une erreur concernant la liaison de int id. Aucune recette n’aura jamais cette adresse, il devrait donc répondre 404.
- Dans
Program.cs, modifie la route du point de terminaison de la leçon précédente en/api/recipes/{id:int}. - Garde une seule route pour celui-ci : modifie la ligne existante, n’en ajoute pas une deuxième.
Essaie : appuie sur Exécuter : GET /api/recipes/2 renvoie toujours la recette Pancakes. Envoie GET /api/recipes/abc : statut 404 et corps vide. La liste Routes affiche GET /api/recipes/{id:int}.
Essayez vous-même
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();
Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.
Toutes les leçons de Minimal APIs
1Premiers endpoints
Votre premier endpointRenvoyer du JSON2Résultats et corps JSON
OK et introuvable