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

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.
主站蜘蛛池模板: 密云县| 新宁县| 尚志市| 兴国县| 明溪县| 廊坊市| 万载县| 昌黎县| 灵山县| 牙克石市| 彭水| 松桃| 嘉黎县| 阿坝县| 龙州县| 延津县| 会昌县| 金溪县| 新津县| 洞头县| 米脂县| 马鞍山市| 台湾省| 崇文区| 长子县| 会宁县| 磴口县| 建宁县| 凤阳县| 五大连池市| 林周县| 彝良县| 台北市| 高要市| 临漳县| 台江县| 正宁县| 金乡县| 广元市| 九江市| 弥渡县|