歡迎光臨
每天分享高質量文章

ASP.NET Core 2.1 : 圖解路由(2.1 or earler)

本文透過一張圖來看一下路由的配置以及請求處理的機制。

一、概述

路由主要有兩個主要功能:

  1. 將請求的URL與已定義的路由進行匹配,找到該URL對應的處理程式並傳入該請求進行處理。
  2. 根據已定義的路由生成URL

這兩個功能看起來這兩個是相反的。

A.路由的配置

路由的兩個功能都離不開一個基本的操作:路由的基本配置。在Startup中預設透過 routes.MapRoute(name: “default”,template: “{controller=Home}/{action=Index}/{id?}”)定義,

當然我們還可以繼續 routes.MapRoute(。。。);  這樣就定義了一系列的路由匹配方式組成一個路由表,例如這樣:

每一個MapRoute會生成一個Route,第二個MapRoute看起來有些特殊,我們可以傳入一個自定義的RequestDelegate(本例為MyRouteHandler.Handler)來處理“flylolo/{code}/{name}”這樣的請求,

它會被封裝成一個RouteHandler(new RouteHandler(MyRouteHandler.Handler))賦值給Route的target屬性,而對於另外兩種沒有指定的,Route的target屬性預設會被指定為MvcRouteHandler ,如下圖:

B.Handler的選擇

當請求進入之後,根據此路由表對該URL進行逐一匹配,並將請求交給匹配到的路由的target(即MvcRouteHandler或RouteHandler),呼叫 _target.RouteAsync(context); ,在這個方法中,若是MvcRouteHandler會對請求的Controller和Action驗證,若驗證成功,則對context(是一個RouteContext)的Handler屬性賦值一個匿名方法;若是RouteHandler則會直接將其封裝的RequestDelegate(本例為MyRouteHandler.Handler)賦值給RouteContext.Handler.

C.請求處理

經過Handler的選擇後,若RouteContext.Handler不為空,則呼叫RouteContext.Handler(HttpContext)對請求進行處理。

D.其他

回想一下中介軟體,這個是不是和app.Map(“/test”, XXHandle)這樣配置中介軟體的方式有點像,當請求路徑是/test的時候,請求交由XXHandle處理,同樣是Map,對比著更容易理解。

下麵透過一張圖看一下路由配置和請求處理的流程。

二、流程及解析

 

  為了方便檢視,對幾個“重點物件”做了顏色標識(點選圖片可以看大圖):

  1. 路由的初始化配置
  2. 一切從Startup開始,之前在中介軟體的文章中介紹過,一般是透過多個UseXXX的方式將多個中介軟體組成“請求處理管道”,而在這裡透過UseMvc方法進行配置,傳入routes.MapRoute(…)這樣的一個或多個配置。
    1. 接下來會New一個

RouteBuilder

  1. ,顧名思義就是一個Route的建立者,透過呼叫傳進來的一個或多個routes.MapRoute()方法生成多個Route,並配置預設的Handler。

①呼叫RouteBuilder的Build方法,生成一個RouteCollection。

RouteCollection實現IRouteCollection和IRouter介面,他是在Startup中的配置組成的集合。

RouterMiddleWare就是專門用於進行路由處理的中介軟體,在此將RouteCollection作為中介軟體RouterMiddleWare的引數,並將這個中介軟體插入管道中。

2. 請求處理流程

        ④請求的處理流程在RouterMiddleWare的invoke()方法中。

      ⑤請求首先會被封裝成一個RouteContext,本質就是將httpContext、_router(也就是RouteCollection)包裝到一個物件裡。

 ⑥呼叫_router(也就是RouteCollection)的RouteAsync(context)方法,在其中遍歷每一個路由

 ⑦若與請求URL匹配,則將對應的Handler賦值給context.Handler。

 ⑧在RouterMiddleWare的invoke()方法中,呼叫新賦值的context.Handler處理HttpContext;

三、其他

      由於文章寫的比較早各種原因一直沒有寫完,現在發現2.2版本之後,啟用了新的路由方案,還是把這章完成了發出來,有願意看的可以參考一下,下一篇文章介紹一下2.2版的新的路由方案,至於透過路由生成URL部分,就暫時不寫了。

贊(0)

分享創造快樂