官术网_书友最值得收藏!

Attribute-based routing

Attribute-based routing allows you to control the exact route that each controller and action takes part in by using the attributes that decorate your controllers and methods. I recommend that you use this approach for most of your APIs, since it will make your code more explicit and reduce routing errors that might be introduced as you add more controllers and actions.

At the beginning of this chapter, we created the ProductsController, which looked like this:

[Route("api/Products")]
[ApiController]
public class ProductsController : Controller
{
...
}

The RouteAttribute attribute that decorates the ProductController contains the URL template that maps to this controller. In this case, every request with a URL prefixed with /api/products/ will be routed to this controller. You can use the RouteAttribute attribute on controllers and on methods, but for methods, it's recommended to use the Http[Verb]Attribute attribute, where [Verb] is one of the standard HTTP verbs (Get, Post, Put, Delete, and so on).

The Http[Verb]Attribute and RouteAttribute attributes can be assigned multiple times to define multiple routes, and are hierarchical, which means that they support route inheritance. This means that if you configured a route on your controller, the routes you define on the methods will extend it.

For example, here is how you can configure that the ProductsController.GetProducts method will be mapped to a HttpGet request to the URL /api/products/all, in addition to the URL /api/products:

[HttpGet]
[HttpGet("all")]
public string[] GetProducts()
{
...
}
If the Http[Verb]Attribute that you set on a method contains a string that begins with /, then it won't be combined with the route defined in the controller, and will instead define a route of its own.
主站蜘蛛池模板: 乌兰察布市| 游戏| 徐州市| 金山区| 长治县| 青浦区| 凤台县| 凤山县| 泗洪县| 天长市| 邵武市| 即墨市| 安丘市| 化州市| 灵台县| 明水县| 长丰县| 金乡县| 柘荣县| 正定县| 林甸县| 奇台县| 遂昌县| 清丰县| 娄烦县| 霍林郭勒市| 桦南县| 宜兴市| 沂源县| 达州市| 中宁县| 小金县| 清徐县| 滨海县| 梅州市| 新丰县| 舞阳县| 德钦县| 土默特左旗| 建始县| 莱芜市|