Menu
CoddyTech

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.

challenge icon

Défi

Facile

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

  1. Dans Program.cs, modifie la route du point de terminaison de la leçon précédente en /api/recipes/{id:int}.
  2. 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();
quiz iconTestez-vous

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