Например, взгляните на приведенный ниже фрагмент кода. Четыре атрибута
Route
на методе действия
Index
эквивалентны маршруту, который был определен ранее. Метод действия
Index
является конечной точкой приложения для
mysite.com
,
mysite.com/Home
,
mysite.com/Home/Index
или
mysite.com/Home/Index/5
.
public class HomeController : Controller
{
[Route("/")]
[Route("/Home")]
[Route("/Home/Index")]
[Route("/Home/Index/{id?}")]
public IActionResult Index(int? id)
{
...
}
}
Основное
различие между маршрутизацией на основе соглашений и маршрутизацией с помощью атрибутов заключается в том, что первая охватывает приложение, тогда как вторая — контроллер с атрибутом
Route
. Если маршрутизация на основе соглашений не применяется, то каждому контроллеру понадобится определить свой маршрут, иначе доступ к нему будет невозможен. Скажем, если в таблице маршрутов не определен стандартный маршрут, тогда следующий код обнаружить не удастся, т.к. маршрутизация для контроллера не сконфигурирована:
public class CarController : Controller
{
public IActionResult Delete(int id)
{
...
}
}
На заметку! Маршрутизацию на основе соглашений и маршрутизацию с помощью атрибутов можно использовать вместе. Если бы в методе
UseEndpoints
был настроен стандартный маршрут контроллера (как в примере с маршрутизацией на основе соглашений), то предыдущий контроллер попал бы в таблицу маршрутов.
Когда маршруты добавляются на уровне контроллера, методы действий получают этот базовый маршрут. Например, следующий маршрут контроллера охватывает
Delete
и любые другие методы действий:
[Route("[controller]/[action]/{id?}")]
public class CarController : Controller
{
public IActionResult Delete(int id)
{
...
}
}
На заметку! При маршрутизации с помощью атрибутов встроенные маркеры помечаются квадратными скобками (
[]
), а не фигурными (
{}
), как при маршрутизации на основе соглашений. Для специальных маркеров применяются все те же фигурные скобки.
Если методу действия необходимо перезапустить шаблон маршрута, тогда нужно предварить маршрут символом прямой косой черты (
/
). Скажем, если метод
Delete
должен следовать шаблону URL вида
mysite.eom/Delete/Car/5
, то вот как понадобится сконфигурировать действие:
[Route("[controller]/[action]/{id?}")]
public class CarController : Controller
{
[Route("/[action]/[controller]/{id}")]
public IActionResult Delete(int id)
{
...
}
}
В маршрутах также можно жестко кодировать значения маршрутов вместо замены маркеров. Показанный ниже код даст тот же самый результат, как и предыдущий:
[Route("[controller]/[action]/{id?}")]
public class CarController : Controller
{
[Route("/Delete/Car/{id}")]
public IActionResult Delete(int id)
{
...
}
}
Именованные маршруты
Маршрутам можно также назначать имена, что обеспечит сокращение для перенаправления по определенному маршруту с указанием только его имени. Например, следующий атрибут маршрута имеет имя
GetOrderDetails
:
[HttpGet("{orderId}", Name = "GetOrderDetails")]
Маршрутизация и методы HTTP
Вы могли заметить, что ни в одном определении шаблона маршрута для методов не присутствует какой-нибудь метод HTTP. Причина в том, что механизм маршрутизации (в приложениях MVC и API) для выбора надлежащей конечной точки приложения использует шаблон маршрута и метод HTTP совместно.
Методы HTTP при маршрутизации в веб-приложениях (MVC)
Довольно часто при построении веб-приложений с применением паттерна MVC соответствовать определенному шаблону маршрута будут две конечные точки приложения. Средством различения в таких ситуациях является метод HTTP. Скажем, если
CarController
содержит два метода действий с именем
Delete
и они оба соответствуют шаблону маршрута, то выбор метода для выполнения основывается на методе HTTP, который используется в запросе. Первый метод
Delete
декорируется атрибутом
HttpGet
и будет выполняться, когда входящим запросом является
GET
. Второй метод
Delete
декорируется атрибутом
HttpPost
и будет выполняться, когда входящим запросом является
POST
:
[Route("[controller]/[action]/{id?}")]
public class CarController : Controller
{
[HttpGet]
public IActionResult Delete(int id)
{
...
}
[HttpPost]
public IActionResult Delete(int id, Car recordToDelete)
{
...
}
}
Маршруты можно модифицировать также с применением атрибутов методов HTTP, а не атрибута
Route
. Например, ниже показан необязательный маркер маршрута