.NET-Core Series
- Server in ASP.NET-Core
- DI in ASP.NET-Core
- Routing in ASP.NET-Core
- Error Handling in ASP.NET-Core
- WebSocket in ASP.NET-Core(一)
- WebSocket in ASP.NET-Core(二)
- To be Continue...
2017年 9月9日更新
路由属性中还可以结合 正则表达式 和其他属性来限制参数
可以参考
- http://sampathloku.blogspot.com/2013/12/attribute-routing-with-aspnet-mvc-5.html
- https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/routing#route-template-reference
[Route("multi/{id:int}")]
public string IntParamsFun()
{
return "Hello,success invoke!";
}
http://localhost:52298/multi/11.2 ` 404 not found`
http://localhost:52298/multi/11 `200 ok `
下面是正则表达式的例子
[Route("regex/{id:regex(^\\d+)}")]
public string RegexFunc()
{
return "Hello,Robert, Regex Invoke Success!";
}
疑问1 当我需要匹配两个参数的路由时需要怎么做，
rewrite-rule/(\d+)/(\d+) 比如这样，就像 rewrite-rule/1111/1111 ,这个的意思相当于 action 是数字的，id 也是数字的 ，可以实现吗？ 好像不行。
在startup 中配置
app.UseMvc(routes =>
{
routes.MapRoute(
name: "Regex",
template: "MultiRegex/{param1}/{param2}",
defaults: new { controller = "Rewrite", action = "MultiRegexFunc" },
constraints: new { param1 = @"^\d+", param2 = @"\d+" });
routes.MapRoute(
name: "default",
template: "{Controller}/{Action}/{Id?}",
defaults: new { controller = "Home", action = "Index" });
});
前言
这篇文章是关于 ASP.NET Core(下文中用AEC简写表示 ASP.NET Core) 中的路由的。主要是从下面两个AEC 官方文档上了解到的内容，再结合自己实践中得出的一些结论，以及一些建议和注意事项。
路由是什么
首先讲讲AEC Mvc中的路由，AEC 中使用 Routing Middleware 即路由中间件来处理URL中的请求，然后映射到相应的Action中。官网的这张Middleware图感觉挺不错。表示了路由的请求以及相应的逻辑。More about Middleware
路由一般定义在Startup.cs 中，或者直接以 Attribute 形式定义在 Controller 中，这两种方法可以混合起来使用，因为两种各有偏好，比如在设计WebApi的时候，可能用属性来定义路由会比较多。向下面这样：
[Route("Hello")]
[HttpGet()]
public IActionResult Index(){
//return View or something.
}
如何使用，创建你的路由
接下来就讲讲如何创建路由，一般我们都是在 Starup.cs 的 Configure 的 app.UseMvc 中定义创建的。就像下面这样，
//Startup.cs
app.UseMvc(options =>
{
options.MapRoute("default","{Controller=Home}/{Action=Index}/{Id?}")
});
//HomeController.cs
public Class HomeControler
{
public string Index(int? id)
{
return $"Hello,Robert!+{id}";
}
}
这样我们就创建好了一个路由，上面的匹配的URL就像这样 /Home/Index/1或者 Home/Index 或者 /Home。因为是默认路由，所以我们比如网页上直接输入localhost:5000的话，就直接导航到这个地方了。
如下图所示：
如果感觉上面的那个写法有点复杂，而且你的项目又只有一个路由的话，你可以直接这样
app.UseMvcWithDefaultRoute();
//Equals to below
app.UseMvc(routes =>
{
routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}");
});
说路由是用 Middleware 的，那么怎么用起了 UseMvc 呢，当我们在使用UseMvc时，就相当于下面这样
var routes = new RouteBuilder(app);
routes.DefaultHandle = new MvcRouteHandler(..);
routes.MapRoute(...);
//创建路由集合，并添加中间件
app.UseRouter(routes.Build());
如果你有多个路由，那么直接在 app.UseMvc 中再自己定义就可以了
app.UseMvc(routes =>
{
routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}");
routes.MapRoute("First","..")
//...
});
如果有下面一段代码：
public class TestController
{
public string Test(int id)
{
return "Test1";
}
public string Test(int id ,string s)
{
return "Test2";
}
}
当我使用URL 为/Test/Test/11/ 你觉得结果会是什么？ 结果就是这个
Microsoft.AspNetCore.Mvc.Internal.AmbiguousActionException: Multiple actions matched. The following actions matched route data and had all constraints satisfied:
程序判断不出哪个到底是最符合的，难道就不能有同名的ActionName 吗？ 未必。接下来就要介绍另外一种 Attribute 形式的路由。
回到上面，我如果改成下面这样，那么就可以完美运行了,
public class TestController
{
public string Test(int id)
{
return "Test1";
}
[HttpPost]
public string Test(int id ,string s)
{
return "Test2";
}
}
结果就是下图预想的这样
除了上面的方式，我们可以直接改写我们刚刚在使用 app.UseMvc() 的那种方式，改为用属性，如下所示：
public class HomeController
{
[Route("")]
[Route("Home")]
[Route("Home/Index")]
public string Index(int? id){
return "Hello, Robert!"
}
}
我们可以使用同样名字的URL，但是导航到不同的地址，这可以通过Http Attribute来实现，如下图所示：
[HttpGet("/products")]
public IActionResult ListProducts()
{
//...
}
[HttpPost("/products")]
public IActionResult CreateProduct(...)
{
//...
}
还有一种情况就是在我们开发Api 的时候挺有用的，比如我想给我的路径前面都加上/api/
那么你可以直接在Class 上面定义属性
[Route("api")]
public class MyApiController
{
//...
}
当然，你也可以定义自己的属性路由，比如像下面这样，
public class MyTestControllerAttribute : Attribute,IRouteTemplateProvider
{
public string Template => "test/[controller]";
public int? Order {get;set;}
public string Name{get;set;}
}
当[MyTestController] 使用时，Template 则自动设置为 test/[controller]
注意事项
需要注意的是，路由是有顺序的，这个顺序就是按照你定义时的顺序，当发起一个请求时，逐个遍历，找到后导航到对应的action，找不到则返回404。