[译]ASP.NET Core 2.0 路由引擎详解

 更新时间:2017年11月01日 11:52:21   作者:三生石上(FineUI控件)  
本篇文章主要介绍了[译]ASP.NET Core 2.0 路由引擎,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧

本文介绍了ASP.NET Core 2.0 路由引擎详解,分享给大家,具体如下:

问题

ASP.NET Core 2.0的路由引擎是如何工作的?

答案

创建一个空项目,为Startup类添加MVC服务和请求中间件:

public void ConfigureServices(IServiceCollection services)

{

  services.AddMvc();

}

 

public void Configure(IApplicationBuilder app, IHostingEnvironment env)

{

  app.UseMvc(routes =>

  {

    routes.MapRoute(

      name: "goto_one",

      template: "one",

      defaults: new { controller = "Home", action = "PageOne" });

 

    routes.MapRoute(

      name: "goto_two",

      template: "two/{id?}",

      defaults: new { controller = "Home", action = "PageTwo" });

 

    routes.MapRoute(

      name: "default",

      template: "{controller=Home}/{action=Index}/{id?}");

  });

} 

创建一个控制器HomeController,来演示常规路由:

public class HomeController : Controller

{

  public IActionResult Index()

  {

    return Content("Home/Index");

  }

 

  public IActionResult PageOne()

  {

    return Content("Home/One");

  }

 

  [HttpGet]

  public IActionResult PageTwo()

  {

    return Content("(GET) Home/Two");

  }

 

  [HttpPost]

  public IActionResult PageTwo(int id)

  {

    return Content($"(POST) Home/Two: {id}");

  }

} 

创建一个控制器WorkController,来演示特性路由:

[Route("work")]

public class WorkController : Controller

{

  public IActionResult Index()

  {

    return Content("Work/Index");

  }

 

  [Route("one")]

  public IActionResult PageOne()

  {

    return Content("Work/One");

  }

 

  [HttpGet("two")]

  public IActionResult PageTwo()

  {

    return Content("(GET) Work/Two");

  }

 

  [HttpPost("two/{id?}")]

  public IActionResult PageTwo(int id)

  {

    return Content($"(POST) Work/Two: {id}");

  }

} 

讨论

ASP.NET Core的路由引擎可以将传入的请求映射到控制器和它们的方法中。这是通过向请求管道中添加路由中间件实现的,具体来说是使用IRouteBuilder将URL规则(模板)映射到一个控制器的方法。

路由模板

路由模板可以使用字面值和标记(标识路由参数)。在匹配一个路由时,字面值会严格匹配URL中的文本,而标记会被替换掉。

为了匹配一个模板,模板中必须包含控制器和方法标记以便定位控制器方法(这是MVC的核心信息)。模板中的其它标记被映射为方法的参数(通过模型绑定实现)。

当添加一个路由映射时,可以为标记提供缺省值。当模板中不包含控制器和方法标记时会很有用。模板也可以包含对应于方法参数的可选标记。

让我们来看一个示例模板:

contact/{controller=Home}/{action=Index}/{id?} 

注意如下几点:

1.标记包含中大括号中。这里有三个标记,分别是controller,action和id。
2.模板中包含一个字面值contact,它会匹配URL中的文本。
3.已经为controller(Home)和action(Index)提供了默认值。
4.可选标记通过问号来声明。

下面的URL会匹配这个模板:

  1. /contact/Home/Index/1: 所有标记都有值。
  2. /contact/Home/Index: 忽略了可选标记。
  3. /contact/Home: 忽略了action标记,将使用默认值Index。
  4. /contact: 忽略了controller和action标记,将分别使用其默认值Home和Index。

常规路由

常规路由为URL路径建立一个约定, 例如给定一个模板:

1.第一个标记映射到控制器
2.第二个标记映射到方法
3.第三个标记映射到可选的方法参数id

你也可以从模板中省略控制器和方法,只要你为它们提供缺省值就行了。比如下面的路由会映射到地址/one,因为通过defaults提供了所需的控制器和方法标记:

routes.MapRoute(

    name: "goto_one",

    template: "one",

    defaults: new { controller = "Home", action = "PageOne" }); 

注:请将此特定路由添加到通用路由之前,因为路由是按照定义的顺序执行的,一旦某个路由匹配成功,则整个匹配流程就会终结。

由于路由中间件只使用了控制器和方法标记来映射到一个控制器方法,因此同一个控制器中放置多个同名的的方法将会抛出异常。为了解决这个问题,可以使用方法上的IActionConstraint特性(比如HttpGet,HttpPost等特性):

[HttpGet("two")]

public IActionResult PageTwo()

{

  return Content("(GET) Work/Two");

}

 

[HttpPost("two/{id?}")]

public IActionResult PageTwo(int id)

{

  return Content($"(POST) Work/Two: {id}");

}

====start by sanshi=========================

为了观察控制器中同名方法出现的异常,我们首先需要修改Configure()方法,添加开发时异常处理中间件: 

public void Configure(IApplicationBuilder app, IHostingEnvironment env)

{

  if (env.IsDevelopment())

  {

    app.UseDeveloperExceptionPage();

  }

 

  app.UseMvc(routes => ....);

} 

修改HomeController: 

public IActionResult PageTwo()

{

  return Content("(GET) Home/Two");

}

public IActionResult PageTwo(int id)

{

  return Content($"(POST) Home/Two: {id}");

} 

看似很正常的重载函数,但是放到控制器中会抛出异常。

在浏览器地址栏敲入:http://localhost:65415/Home/PageTwo,观看到异常页面:

 

====end by sanshi=========================  

特性路由

特性路由通过直接为控制器和方法提供路由模板来实现。

我们可以使用[Route]或者[HttpGet](或者其他动词)特性来指定模板。这些模板可以包含字面值和标记(不能包含控制器和方法标记)。

运行时,控制器的特性模板和方法的特性模板会被合并到一起,比如,在WorkController中,PageOne方法可以通过/work/one访问:

[Route("work")]

public class WorkController : Controller

{

  [Route("one")]

  public IActionResult PageOne()

  {

    return Content("Work/One");

  }

} 

源代码下载

原文:https://tahirnaushad.com/2017/08/20/asp-net-core-mvc-routing/

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。

相关文章

  • .Net Core 中选项Options的具体实现

    .Net Core 中选项Options的具体实现

    这篇文章主要介绍了.Net Core 中选项Options的具体实现,文中运用大量代码对相关知识详细介绍,感兴趣的小伙伴可以参考一下这篇文章,希望对你有所帮助
    2021-09-09
  • asp.net下比较两个等长字符串是否含有完全相同字符(忽略字符顺序)

    asp.net下比较两个等长字符串是否含有完全相同字符(忽略字符顺序)

    项目中遇到一个好玩的问题,需要比较两个选择区域选择的文字是否一样,就想到将这两个区域中选中的文字链接起来进行两个字符串之间的比较
    2010-06-06
  • ASP.NET数据库缓存依赖实例分析

    ASP.NET数据库缓存依赖实例分析

    这篇文章主要介绍了ASP.NET数据库缓存依赖,以实例的形式分析总结了数据库缓存依赖的原理与用法,非常具有实用价值,需要的朋友可以参考下
    2014-10-10
  • 如何对ASP.NET网站实现静态化

    如何对ASP.NET网站实现静态化

    对于访问量比较大的网站,网页静态化是一个比较可靠的解决方案。静态化将显著降低服务器的压力,提升服务器处理能力。下面将介绍两种不同的实现方法,并进行对比。
    2015-09-09
  • .Net Core项目如何添加日志功能详解

    .Net Core项目如何添加日志功能详解

    这篇文章主要给大家介绍了关于.Net Core项目如何添加日志功能的相关资料,日志功能是我们开发中经常需要用到的一个功能,文中通过示例代码介绍的非常详细,需要的朋友可以参考借鉴,下面随着小编来一起学习学习吧
    2018-07-07
  • URL重写及干掉ASP.NET试图状态的实现方法

    URL重写及干掉ASP.NET试图状态的实现方法

    URL重写已经很普遍了,但基本上大部分的URL重写都不支持页面的相对路径,所有如果想在已经开发好的项目中添加还是有压力的,第二就是例如微软的那个URL重写是根据正则表达式来处理的,那样是很好,但也有不足之处,就是不方便定位到某个页面只能有哪些参数
    2011-11-11
  • ASP.NET Core 5中如何生成PDF文档

    ASP.NET Core 5中如何生成PDF文档

    这篇文章主要给大家介绍了关于ASP.NET Core 5中如何生成PDF文档的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-03-03
  • ASP.NET Core扩展库的相关功能介绍

    ASP.NET Core扩展库的相关功能介绍

    这篇文章主要介绍了ASP.NET Core扩展库的相关功能,帮助大家更好的理解和学习使用.Net技术,感兴趣的朋友可以了解下
    2021-03-03
  • ASP.NET中使用GridView实现分级显示的代码

    ASP.NET中使用GridView实现分级显示的代码

    在实际项目开发中,往往需要用到在页面上对列表的项目实现分级显示,在 ASP.NET中没有现成的控件。
    2010-06-06
  • ASP.NET.4.5.1+MVC5.0设置系统角色与权限(二)

    ASP.NET.4.5.1+MVC5.0设置系统角色与权限(二)

    这篇文章主要介绍了使用ASP.NET.4.5.1+MVC5.0构建项目中设置系统角色的全部过程,十分的详细,附上全部源码,推荐给想学习.net+mvc的小伙伴们
    2015-01-01

最新评论