ASP.NET Core 2.0路由引擎是如何工作的
创始人
2024-11-27 21:22:52
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,观看到异常页面:

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

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

特性路由

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

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

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

[Route("work")]

public class WorkController : Controller

{

  [Route("one")]

  public IActionResult PageOne()

  {

    return Content("Work/One");

  }

}

相关内容

热门资讯

空调连续工作多久需要停机休息 空调连续工作的时间取决于多个因素,包括空调的型号、功率、使用环境和维护情况等。一般来说,空调可以连续...
空调哪个符号是除湿的 空调除湿功能通常用一个水滴形状的符号表示。不同品牌和型号的空调遥控器可能会有所差异,但一般来说,除湿...
格力空调多长时间加一次氟利昂 1、一般情况下,空调对氟利昂的使用量是非常小的,所以在空调使用了四年左右的时候再考虑加也没问题。2、...
空调用多长时间需要加氟一次 一般情况下是五年。当出现以下这几种情况时,空调才需要加氟。1、空调的室内机和室外机各有两个接口,当接...
格调生活·C标思享荟:卡萨帝在... 9月12日的郑州龙湖金融岛,夜风轻拂,灯光璀璨。“C标时刻共传奇——卡萨帝思享荟暨20周年品牌盛典郑...
品牌价值破千亿、高端份额持续领... 9月12日,“C标时刻共传奇——卡萨帝思享荟暨20周年品牌盛典郑州站”在郑州龙湖金融岛举办。2026...
空调主板坏了修800还是换新的 空调主板坏了是修还是换新,需要考虑多个因素,以下是一些建议:1. 维修成本:如果维修费用较低,比如 ...
空调开多久需要休息多长时间 问题:空调开多久需要休息多长时间回答:1、在使用空调的过程中,一般空调开7~8个小时左右需要休息2~...
中央空调多长时间清洗一次 1、一般空调开机前清洗一次即可,空调开机中间时段再清洗一次,空调关机时清洗一次,这样比较合理。2、空...
中央空调氟利昂多久加一次 看空调制热和制冷程度,很多人的观点认为氟利昂必须一年放一次,其实这个观点是错误的,理解上面有点偏差,...