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

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.
主站蜘蛛池模板: 建始县| 正定县| 渭南市| 许昌市| 白河县| 衡阳市| 上思县| 邻水| 银川市| 木里| 顺义区| 兴城市| 林西县| 姚安县| 永济市| 蒙阴县| 台南县| 台北县| 枣庄市| 遂溪县| 巴林右旗| 沁源县| 蒲城县| 玛沁县| 桦南县| 威海市| 北碚区| 太白县| 昌吉市| 托克托县| 龙井市| 雷州市| 麦盖提县| 康保县| 龙泉市| 广德县| 漳州市| 沽源县| 昌吉市| 佛山市| 宁国市|