[譯]ASP.NET Core 2.0 路由引擎詳解

更新時(shí)間：2017年11月01日 11:52:21 作者：三生石上(FineUI控件)

本篇文章主要介紹了[譯]ASP.NET Core 2.0 路由引擎，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧

本文介紹了ASP.NET Core 2.0 路由引擎詳解，分享給大家，具體如下：

問題

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

答案

創(chuàng)建一個(gè)空項(xiàng)目，為Startup類添加MVC服務(wù)和請求中間件：

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?}");

  });

}

創(chuàng)建一個(gè)控制器HomeController，來演示常規(guī)路由：

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}");

  }

}

創(chuàng)建一個(gè)控制器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的路由引擎可以將傳入的請求映射到控制器和它們的方法中。這是通過向請求管道中添加路由中間件實(shí)現(xiàn)的，具體來說是使用IRouteBuilder將URL規(guī)則（模板）映射到一個(gè)控制器的方法。

路由模板

路由模板可以使用字面值和標(biāo)記（標(biāo)識(shí)路由參數(shù)）。在匹配一個(gè)路由時(shí)，字面值會(huì)嚴(yán)格匹配URL中的文本，而標(biāo)記會(huì)被替換掉。

為了匹配一個(gè)模板，模板中必須包含控制器和方法標(biāo)記以便定位控制器方法（這是MVC的核心信息）。模板中的其它標(biāo)記被映射為方法的參數(shù)（通過模型綁定實(shí)現(xiàn)）。

當(dāng)添加一個(gè)路由映射時(shí)，可以為標(biāo)記提供缺省值。當(dāng)模板中不包含控制器和方法標(biāo)記時(shí)會(huì)很有用。模板也可以包含對(duì)應(yīng)于方法參數(shù)的可選標(biāo)記。

讓我們來看一個(gè)示例模板：

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

注意如下幾點(diǎn)：

1.標(biāo)記包含中大括號(hào)中。這里有三個(gè)標(biāo)記，分別是controller，action和id。
2.模板中包含一個(gè)字面值contact，它會(huì)匹配URL中的文本。
3.已經(jīng)為controller（Home）和action（Index）提供了默認(rèn)值。
4.可選標(biāo)記通過問號(hào)來聲明。

下面的URL會(huì)匹配這個(gè)模板：

/contact/Home/Index/1: 所有標(biāo)記都有值。
/contact/Home/Index: 忽略了可選標(biāo)記。
/contact/Home: 忽略了action標(biāo)記，將使用默認(rèn)值Index。
/contact: 忽略了controller和action標(biāo)記，將分別使用其默認(rèn)值Home和Index。

常規(guī)路由

常規(guī)路由為URL路徑建立一個(gè)約定, 例如給定一個(gè)模板:

1.第一個(gè)標(biāo)記映射到控制器
2.第二個(gè)標(biāo)記映射到方法
3.第三個(gè)標(biāo)記映射到可選的方法參數(shù)id

你也可以從模板中省略控制器和方法，只要你為它們提供缺省值就行了。比如下面的路由會(huì)映射到地址/one，因?yàn)橥ㄟ^defaults提供了所需的控制器和方法標(biāo)記：

routes.MapRoute(

    name: "goto_one",

    template: "one",

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

注：請將此特定路由添加到通用路由之前，因?yàn)槁酚墒前凑斩x的順序執(zhí)行的，一旦某個(gè)路由匹配成功，則整個(gè)匹配流程就會(huì)終結(jié)。

由于路由中間件只使用了控制器和方法標(biāo)記來映射到一個(gè)控制器方法，因此同一個(gè)控制器中放置多個(gè)同名的的方法將會(huì)拋出異常。為了解決這個(gè)問題，可以使用方法上的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=========================

為了觀察控制器中同名方法出現(xiàn)的異常，我們首先需要修改Configure()方法，添加開發(fā)時(shí)異常處理中間件：

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}");

}

看似很正常的重載函數(shù)，但是放到控制器中會(huì)拋出異常。

在瀏覽器地址欄敲入：http://localhost:65415/Home/PageTwo，觀看到異常頁面：

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

特性路由

特性路由通過直接為控制器和方法提供路由模板來實(shí)現(xiàn)。

我們可以使用[Route]或者[HttpGet]（或者其他動(dòng)詞）特性來指定模板。這些模板可以包含字面值和標(biāo)記（不能包含控制器和方法標(biāo)記）。

運(yùn)行時(shí)，控制器的特性模板和方法的特性模板會(huì)被合并到一起，比如，在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/

以上就是本文的全部內(nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: