NetCore路由的Endpoint模式
??? IdentityServer里有各種Endpoint,如TokenEndpoint,UserInfoEndpoint,Authorize Endpoint,Discovery Endpoint等等。Endpoint從字面意思來看是“終端節點"或者“終節點”的意思。無獨有偶NetCore的路由也有Endpoint的概念。那么我們提出一個問題來,究竟什么是Endpoint?
? ? 先來看一段代碼,如下所示:
? ??
?View Code
上面的代碼很清晰,如果路由格式匹配”weather/{city}/{year}.{month}.{day}”,那么就調用WeatherForecast方法,這里的app.UseRouting().UseEndpoints就用到了Endpoint模式。要了解Endpoint,我們需要抽絲剝繭一步一步了解幾個類的方法:
? ?1.我們先看最里面的endpoints =>endpoints.MapGet("weather/{city}/{year}.{month}.{day}", WeatherForecast),這里實際上調用的是EndpointRouteBuilderExtensions類的MapGet方法,代碼如下所示:
?View Code
在這里我們重點看看下面簽名的方法:
?View Code
在這個方法里有一個實例化RouteEndpointBuilder的語句:
var builder = new RouteEndpointBuilder(requestDelegate,pattern,defaultOrder){DisplayName = pattern.RawText ?? pattern.DebuggerToString(),};其中RouteEndpointBuilder從字面意思看得出,就是RouteEndpoint的創建者,我們看下它的代碼:
?View Code
再來看下Endpoint的代碼:
?View Code
從Build()方法看得出,它利用路由匹配的RoutePattern,生成一個RouteEndpoint實例。RouteEndpoint叫做路由終點,繼承自Endpoint。Endpoint有一個重要的RequestDelegate屬性,用來處理當前的請求。看到這里,我們開始推斷:所謂的Endpoint,無非就是用要匹配的pattern,構造一個RouteEndpoint的過程,其中RouteEndpoint繼承自Endpoint。NetCore無非就是利用這個RouteEndpoint來匹配當前的Url,如果匹配得上,就執行RequestDelegate所代表的方法,上文就是WeatherForecast方法,如果匹配不上,則不執行WeatherForecast方法,僅此而已。
? 2.為了驗證,我們再來看?app.UseRouting().UseEndpoints(),實際上調用的是EndpointRoutingApplicationBuilderExtensions類的兩個方法:
?View Code
???2-1首先看UseRouting()方法,這個方法其實就是調用EndpointRoutingMiddleware中間件進行Endpoint的匹配,我們可以看下它的幾個方法:
??
?View Code
從Invoke方法看得出來,它根據當前的HttpContext進行Endpoint的匹配,如果當前的HttpContext路由格式匹配成功,那么將當前HttpContext傳遞給下一個中間件處理,這個從SetRoutingAndContinue方法看得出來。
?2-2其次看下UseEndpoints()方法,這個方法就是調用EndpointMiddleware中間件,對上面匹配成功的HttpContext進行處理,并調用HttpContext的EndPoint的RequestDelegate處理當前請求。我們重點看下它的Invoke方法,重點關注var requestTask = endpoint.RequestDelegate(httpContext):
?View Code
? 總結:從上面的分析,我們粗略的了解了netcore路由的Endpoint模式其實就是一種用匹配模式構建的終端節點,它主要用來對HttpContext進行路由的匹配,如果匹配成功,則執行Endpoint上的RequestDelegate方法。
總結
以上是生活随笔為你收集整理的NetCore路由的Endpoint模式的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 淘集集打单软件那个好?那个打单软件能批量
- 下一篇: 微软ERP平台迁移