(8)ASP.NET Core 中的MVC路由(一)
1.前言
ASP.NET Core MVC使用路由中介軟體來匹配傳入請求的URL並將它們對映到操作(Action方法)。路由在啟動程式碼(Startup.Configure方法)或屬性(Controller Action屬性)中定義。路由描述應如何將URL路徑與操作(Action方法)相匹配。它還用於在響應中生成送出的URL。
路由操作可以設定中介軟體,支援傳統路由、屬性理由(通過在Controller Action上放置理由可實現)、多個路由。
2.設定路由中介軟體
在Configure方法中,可能會看到與下面類似的設定路由中介軟體程式碼:
app.UseMvc(routes => { routes.MapRoute(name: "default", template: "{controller=Home}/{action=Index}/{id?}"); });
等價於
//預設模版就是 "{controller=Home}/{action=Index}/{id?}" app.UseMvcWithDefaultRoute();
在UseMvc的匿名方法中,MapRoute表示建立單個路由,指定為預設(default)路由、路由模版“{controller=Home}/{action=Index}/{id?}”。
路由模版“{controller=Home}/{action=Index}/{id?}”的意思是可以匹配“/Home/Index/5”的URL路徑。也就是說:
●{controller=Home}將Home定義為預設controller。
●{id?}將id定義為可選引數。
UseMvc和UseMvcWithDefaultRoute可向中介軟體管道新增RouterMiddleware的例項。MVC不直接與中介軟體互動,而是使用路由來處理請求。MVC通過MvcRouteHandler例項連線到路由。 過載UseMvc(Action<IRouteBuilder>) 則允許使用者新增自己的路由,並且還支援屬性路由。UseMvcWithDefaultRoute定義預設路由並支援屬性路由。
3.傳統路由
預設路由:
routes.MapRoute(name: "default", template: "{controller=Home}/{action=Index}/{id?}");
●第一個路徑段對映到控制器名稱
●第二段對映到操作名稱。
●第三段用於可選id(用於對映到模型實體)。
使用此default路由時,URL路徑/Home/Index對映到HomeController.Index。此對映僅基於控制器和操作(action)名稱,而不基於名稱空間、原始檔位置或方法引數。
4.多個路由
4.1定義多個路由
通過對UseMvc匿名方法新增多個路由,這樣做可以定義多個約定或新增專用於特定操作的傳統路由,比如:
app.UseMvc(routes => { //第一個路由 routes.MapRoute("blog", "blog/{*article}",defaults: new { controller = "Blog", action = "Article" }); //第二個路由 routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); });
第一個路由裡{*article}是表示使用catch-all路由引數來捕獲URL路徑的剩餘部分。下面我們通過測試來驗證下:
●"blog/{*article}":
●"blog/{article}":
通過上述測試可以知道,加星號的路由在傳參字串中加了斜槓依然能夠開啟,沒加星號的路由在傳參字串中加了斜槓就不能打開了。還有一點要注意的是controller.action接收引數必須跟*後面引數名稱一致,不然會接收不到引數值。
4.2區分操作
當controller存在兩個action名稱一致的方法,MVC必須要進行區分,不然會引發異常,例如:
public class BlogController : Controller { public IActionResult Edit(int id) {} [HttpPost] public IActionResult Edit(int id, Blog blog) {} }
當請求為HTTP POST時MVC會選擇Edit(int, Blog),在Http屬性為任何其他內容時選擇 Edit(int)。如果匹配多個路由,而MVC找不到“最佳”路由Action時,則會引發 AmbiguousActionException異常。
5.屬性路由
5.1 屬性路由
屬性路由使用一組屬性將操作(Action)直接對映到路由模板。 在下面的示例中,Configure 方法使用app.UseMvc(),不傳遞任何路由。HomeController將匹配一組URL,這組URL與預設路由{controller=Home}/{action=Index}/{id?}匹配的URL類似:
public class HomeController : Controller { [Route("")] [Route("Home")] [Route("Home/Index")] public IActionResult Index() { return View(); } }
下面我們通過表格來看看每個屬性路由在瀏覽器上開啟連結是怎樣的效果。
Route Template |
Browser |
Page |
Route("") |
[SERVICE_NAME] |
[SERVICE_NAME]/Home/Index |
Route("Home") |
[SERVICE_NAME]/Home |
|
Route("Home/Index") |
[SERVICE_NAME]/Home/Index |
三種屬性路由在瀏覽器上開啟連結方式都不一樣,但是呈現頁面是一樣的,也就是說三個屬性路由的定義方式都是指向同一個/Home/Index頁面。到這裡或許大夥會有疑問,如果我把三個屬性路由模版名稱都改變下,那會能開啟同一個頁面麼?
[Route("1")] [Route("Home1")] [Route("Home1/Index1")]
上述模版名稱更改了,但是在瀏覽器呈現頁面還是指向/Home/Index的,也就是說,無論屬性路由模版名稱如何更改總能開啟對應/Home/Index頁面。
5.2 使用 Http[Verb] 屬性的屬性路由
屬性路由還可以使用Http[Verb]屬性,比如HttpPostAttribute。所有這些屬性都可採用路由模板。此示例展示與同一路由模板匹配的兩項操作:
public class BlogController : Controller { [HttpGet("/article/{id}", Name = "Article_List")] public IActionResult Article(string id) { return View(); } }
當我們在瀏覽器上輸入[SERVICE_NAME]/article/1時候,通過DEBUG我們可以看到響應結果:
通過響應結果可以知道屬性路由首先將URL與路由屬性定義的路由模板集([HttpGet("/article/{id}", Name = "Article_List")])進行匹配。一旦某個路由模板匹配,就會應用IActionConstraint約束來確定可以執行的操作。
5.3合併路由
根據業務場景如果我們需要將某個Controller重新命名為以便訪問該Controller下面所有action,那麼該如何設定呢?下面通過示例來演示下:
[Route("homes")] public class HomeController : Controller { [HttpGet("{id}")] public IActionResult Index() { return View(); } }
根據上述程式碼,在HomeController上放置路由屬性([Route("homes")])會使控制器中的所有操作(Action)都使用該屬性路由。也就是說只有URL HTTPGet :[SERVICE_NAME]/homes/1才能訪問Index檢視。這種做法好處是,HomeController下的每個Action操作不用單獨新增Route("homes")屬性,只需要在HomeController外放置一個全域性Route("homes")屬性即可應用到每個Action去,減少路由屬性重複。
5.4指定屬性路由的可選引數、預設值和約束
屬性路由同時也支援使用與傳統路由相同的內聯語法,來指定可選引數、預設值和約束。下面請看示例:
public class HomeController : Controller { [HttpGet("homes/{id:int}")] public IActionResult Index(int id) { return View(); } }
上述程式碼執行結果我們通過表格來看看效果:
Browser |
Result status |
[SERVICE_NAME]/homes/1 |
200 |
[SERVICE_NAME]/homes/qwe |
404 |
[HttpGet("homes/{id:int}")]把傳入id引數值約束為只有數字才能開啟該屬性下檢視,如果傳入是字串則無法找到該檢視。而更多路由約束模板在這裡參閱。
5.4自定義屬性路由
我們可以通過框架自帶的IRouteTemplateProvider介面自定義路由屬性(例如類似[HttpGet]、[Route("homes")]等屬性)。當應用程式啟動時,MVC會查詢控制器類和操作方法上的屬性,並使用實現IRouteTemplateProvider的屬性生成一組初始路由。此部分通過一個簡單的示例說明了如何使用應用程式自定義屬性路由:
public class MyControllerAttribute : Attribute, IRouteTemplateProvider { //實現介面的三個屬性,這裡的[controller]是一個標記替換。 public string Template => "api/[controller]/{action}/{id?}"; public int? Order { get; set; } public string Name { get; set; } }
新建一個路由屬性類自定義屬性路徑,然後在Controller或者Action上放置自定義屬性路由。
public class BlogController : Controller { [MyController()] public IActionResult Article(string id) { return View(); } }
通過執行[SERVICE_NAME]/api/Blog/Article/1連結時訪問成功,也就是說自定義屬性路由成功。
參考文獻:
在 ASP.NET Core 中路由到控制器操作