Ограничения маршрута
Часть раздела Минимальные API путешествия по ASP.NET Core на Coddy. Урок 4 из 20.
GET /orders/abc соответствует /orders/{number}, а затем не удаётся преобразовать abc в int: 400 Bad Request. Ограничение маршрута после двоеточия ограничивает значения, которым может соответствовать параметр, поэтому этот путь не соответствует ни одному маршруту и возвращает 404 Not Found.
app.MapGet("/orders/{number:int}", (int number) => $"Order {number}");
app.MapGet("/orders/{code:alpha}", (string code) => $"Code {code}");:int соответствует целым числам, а :alpha — буквам, поэтому /orders/7 и /orders/abc каждый соответствует одному маршруту. Другие ограничения: :guid, :min(1) и :length(3); их можно объединять в цепочки: {number:int:min(1)}. Ограничения выбирают маршрут; они не проверяют пользовательский ввод, потому что отклонённое значение приводит к ответу 404, а не 400.
Задание
ЛегкоGET /api/recipes/abc отвечает кодом 400 с ошибкой, связанной с привязкой int id. У рецепта никогда не будет такого адреса, поэтому ответ должен быть 404.
- В
Program.csизмените маршрут конечной точки из предыдущего урока на/api/recipes/{id:int}. - Оставьте для неё один маршрут: измените существующую строку, не добавляйте вторую.
Попробуйте: нажмите «Запустить»: GET /api/recipes/2 по-прежнему возвращает рецепт Pancakes. Отправьте GET /api/recipes/abc: статус 404 и пустое тело ответа. В списке Routes отображается GET /api/recipes/{id:int}.
Попробуйте сами
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();
В этом уроке есть небольшой тест. Начните урок, чтобы ответить на вопросы и сохранить прогресс.
Все уроки раздела Минимальные API
1Первые конечные точки
Ваша первая конечная точкаВозврат JSON