• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

Routing in ASP.NET Core

原作者: [db:作者] 来自: [db:来源] 收藏 邀请

.NET-Core Series

2017年 9月9日更新

路由属性中还可以结合 正则表达式 和其他属性来限制参数

 可以参考

        [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。

参考链接


鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
asp.net 2.0 下集成OCX 全过程发布时间:2022-07-10
下一篇:
Asp.net安装包制作发布时间:2022-07-10
热门推荐
热门话题
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap