.NET Core源碼解析配置文件及依賴注入

這篇文章我們設計了一些複雜的概念,因爲要對ASP.NET Core的啓動及運行原理、配置文件的加載過程進行分析,依賴注入,控制反轉等概念的講解等

寫在前面

上篇文章我給大家講解了ASP.NET Core的概念及爲什麼使用它,接着帶着你一步一步的配置了.NET Core的開發環境並創建了一個ASP.NET Core的mvc項目,同時又通過一個實戰教你如何在頁面顯示一個Content的列表。不知道你有沒有跟着敲下代碼,千萬不要做眼高手低的人哦。

這篇文章我們就會設計一些複雜的概念了,因爲要對ASP.NET Core的啓動及運行原理、配置文件的加載過程進行分析,依賴注入,控制反轉等概念的講解等。

俗話說,授人以魚不如授人以漁,所以文章旨在帶着大家分析源碼,讓大家能知其然更能知其所以然。爲了偷懶,繼續使用上篇文章的例子了!

ASP.NET Core啓動源碼解析

這部分我就帶着大家一起看下asp.net core項目的運行流程吧!順帶着瞭解下asp.net core的運行原理,說的不好的話,希望大家給以指正,從而能夠正確的幫助更多的人。

1.首先上一下上篇文章的項目結構吧,如下所示,熟悉C#的朋友應該知道,要找程序的入庫,那麼就應該找到Main方法。而asp.net core的main方法就在Program.cs文件中。

2.打開後看到如下的代碼,我加了註釋,大夥將就看下,下面我們來一步一步的分析

/// <summary>
 /// Main方法,程序的入口方法
 /// </summary>
 /// <param name="args"></param>
 public static void Main(string[] args)
 {
  CreateWebHostBuilder(args)//調用下面的方法,返回一個IWebHostBuilder對象
  .Build()//用上面返回的IWebHostBuilder對象創建一個IWebHost
  .Run();//運行上面創建的IWebHost對象從而運行我們的Web應用程序換句話說就是啓動一個一直運行監聽http請求的任務
 }

 public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
  WebHost.CreateDefaultBuilder(args)//使用默認的配置信息來初始化一個新的IWebHostBuilder實例
  .UseStartup<Startup>();// 爲Web Host指定了Startup類

3.可以看到asp.net core程序實際上就是一個控制檯程序,運行一個webhost對象從而啓動一個一直運行的監聽http請求的任務。所以我們的重點就是分析一下這個WebHost創建的過程:

創建IWebHostBuilder-》創建IWebHost-》然後運行創建的IWebHost。

4.這裏我們從IWebHostBuilder的Build分析下創建的過程,有興趣的朋友可以看下,沒興趣的朋友可以直接跳到下一個步驟繼續閱讀。

                1.首先到aspnetcore的github開源地址https://github.com/aspnet/AspNetCore/tree/release/2.1 上去下載源碼(我們使用的是2.1)。然後使用vscode打開解壓後的文件夾。至於vscode如何加載文件,你可以看我這篇文章使用Visual Studio Code開發.NET Core看這篇就夠了

                2.根據IWebHostBuilder的命名空間我們找到了它的實現,路徑爲src/Hosting/Hosting/src/WebHostBuilder.cs

                3.通過上面的代碼我們可以看到首先是通過BuildCommonServices來構建一個ServiceCollection。爲什麼說這麼說呢,先讓我們我們跳轉到BuidCommonServices方法中看下吧。

可以看到,var services = new ServiceCollection();首先new一個ServiceCollection然後往services裏面注入很多內容,比如:WebHostOptions ,IHostingEnvironment ,IHttpContextFactory ,IMiddlewareFactory 等等(其實這裏已經設計到依賴注入的概念了,先思考下吧),然後我們在後續就可以使用了!最後這個BuildCommonServices就返回了這個services對象。

                4.在上面的依賴注入中有一個方法,不知道大家注意到沒有,因爲我們在步驟2貼出的代碼裏面有一個UseStartup<Startup>() 其實在上面的BuildCommonServices方法中也有對IStartup的注入的。首先,判斷Startup類是否繼承於IStartup接口,如果是繼承的,那麼就可以直接加入在services 裏面去,如果不是繼承的話,就需要通過ConventionBasedStartup(methods)把method轉換成IStartUp後注入到services裏面去。結合上面我們的代碼,貌似我們平時用的時候注入的方式都是採用後者。

                5.我們再回到build方法拿到了BuildCommonServices方法構建的ServiceCollection實例後,通過GetProviderFromFactory(hostingServices) 方法構造出了IServiceProvider 對象。到目前爲止,IServiceCollection和IServiceProvider都拿到了。然後根據IServiceCollection和IServiceProvider對象構建WebHost對象。構造了WebHost實例還不能直接返回,還需要通過Initialize對WebHost實例進行初始化操作。那我們看看在初始化函數Initialize中,都做了什麼事情吧。

                6.這裏我們把代碼導航到src/Hosting/Hosting/src/Internal/WebHost.cs找到Initialize方法。如下圖所示:主要就是一個EnsureApplicationServices 方法。

                7.我們繼續導航查看這個方法的內容如下:就是拿到Startup 對象,然後把_applicationServiceCollection 中的對象注入進去。

                8.至此我們build中註冊的對象以及StartUp中註冊的對象都已經加入到依賴注入容器中了,接下來就是Run起來了。這個run的代碼在src\Hosting\Hosting\src\WebHostExtensions.cs中,代碼如下:

WebHost執行RunAsync運行web應用程序並返回一個只有在觸發或關閉令牌時才完成的任務(這裏又涉及到異步編程的知識了,咱們以後再詳細講解) 。這就是我們運行ASP.Net Core程序的時候,看到的那個命令行窗口了,如果不關閉窗口或者按Ctrl+C的話是無法結束的。

                9.至此啓動的過程的源碼分析完成了。

配置文件

上面給大家介紹了ASP.NET Core的啓動過程,中間牽扯到了一些依賴注入的概念。關於依賴注入的概念呢,我們後面再說,這裏先給大家講解下配置文件的加載過程。

4.打開上篇文章我們創建的項目,並在appsettings.json裏面加入如下內容:

{
 "Logging": {
 "LogLevel": {
 "Default": "Warning"
 }
 },
 "Content": {
 "Id": 1,
 "title": "title1",
 "content": "content1",
 "status": 1,
 "add_time": "2018-11-21 16:29",
 "modify_time": null
 },
 "AllowedHosts": "*"
}

5.然後在Startup類中ConfigureServices中註冊TOptions對象如下所示:

services.Configure<Content>(Configuration.GetSection("Content"));//註冊TOption實例對象

這段代碼也就是從appsettings.json這個配置文件中的Content這個節點匹配到Content這個對象上。

6.修改下ContentController這個控制器代碼如下:

private readonly Content contents;
 public ContentController(IOptions<Content> option)
 {
  contents = option.Value;
 }
 /// <summary>
 /// 首頁顯示
 /// </summary>
 /// <returns></returns>
 public IActionResult Index()
 {

  return View(new ContentViewModel { Contents=new List<Content> { contents} });
 }

7.按下F5運行下,然後導航到Content目錄看到如下頁面:說明成功從appsettings.json這個文件中加載了內容。這一切是怎麼發生的呢?下面我們就一步一步的來分析。

8.我們回過頭來看我們的Main方法,發現裏面有一個CreateDefaultBuilder方法,就是這個方法裏面爲我們做了一些默認的設置,然後加載我們的配置文件的!

9.我們在源碼裏面找到CreateDefaultBuilder 的源碼(反正我找了半天,起初在Hosting下面找,實際上在MetaPackages下面的),位置在src\MetaPackages\src\Microsoft.AspNetCore\WebHost.cs 有的人可能找不到哦,可以看到這個方法會在ConfigureAppConfiguration 的時候默認加載appsetting文件,並做一些初始的設置,所以我們不需要任何操作,就能加載appsettings 的內容了。

10.既然知道了原理後,我們就試着重寫下這個ConfigureAppConfiguration 然後加載我們自定義的json文件吧。

11.鼠標右鍵新建一個Content.json文件,然後輸入如下的內容:

{
 "ContentList": 
 {
 "Id": 1,
 "title": "title1 from diy json",
 "content": "content1 from diy json",
 "status": 1,
 "add_time": "2018-11-21 16:29",
 "modify_time": null
 }

}

12.然後打開Program.cs。按如下代碼進行改造:

/// <summary>
 /// Main方法,程序的入口方法
 /// </summary>
 /// <param name="args"></param>
 public static void Main(string[] args)
 {
  CreateWebHostBuilder(args)//調用下面的方法,返回一個WebHostBuilder對象
  .Build()//用上面返回的WebHostBuilder對象創建一個WebHost
  .Run();//運行上面創建的WebHost對象從而運行我們的Web應用程序換句話說就是啓動一個一直運行監聽http請求的任務
 }

 public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
  WebHost.CreateDefaultBuilder(args)//使用默認的配置信息來初始化一個新的IWebHostBuilder實例
  .ConfigureAppConfiguration((hostingContext, config) =>
  {
  var env = hostingContext.HostingEnvironment;

  config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
   .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true, reloadOnChange: true)
   .AddJsonFile("Content.json",optional:false,reloadOnChange:false)
   .AddEnvironmentVariables();

  })
  .UseStartup<Startup>();// 爲Web Host指定了Startup類

13.然後Startup裏面ConfigureServices中的代碼修改如下:

14.然後按下F5運行下代碼吧,如下圖所示,從我們最新添加的json文件中加載出來數據了。

15.這裏多講一點,傳統asp.net的web.config文件如果有更改的話是必須要重啓站點才能使,配置文件生效的,但是asp.net core的配置文件是支持熱更新的,及不重啓網站也能加載更新,只需要設置一下屬性即可,如下圖所示:

16.配置文件的源碼解讀這塊就到這裏了。下面開始依賴注入的講解。

依賴注入與控制反轉

如果大家仔細閱讀文章的話,相信已經看出來了,我上面提到過好幾次依賴注入的概念。那麼究竟什麼是依賴注入呢?下面我們就拿我們上面的ContentController來好好的來理解下。

依賴注入:當一個對象ContentController需要另一個對象Content來協同完成任務的時候,那麼這個ContentController就對這個Content對象產生了依賴關係。那麼在這個ContentController中,是怎麼注入的呢?就是從控制器中注入的了,如下圖所示:

從asp.net 轉過來的你是不是想起了之前的千篇一律的new對象啊。沒對象自己new(要是女朋友也能new多好啊……)當然除了單例對象,靜態哈。

這裏又設計一個概念就是控制反轉。

那麼什麼是控制反轉呢?你上面看到沒有,你自己new對象就是正轉,因爲你自己創建自己所要使用的對象,。那麼這種不需要你自己new對象,而是直接傳進來就是控制反轉了。(不知道比喻的恰不恰當哈)

依賴注入與控制反轉你是否已經瞭解了呢,喜歡思考的朋友可能會問了,那這個構造函數裏面的IOptions<Content> option 又是怎麼出來的?這裏就要引入一個容器的概念了。

什麼是容器呢?

這裏創建IOptions<Content> option 這個對象的東西就是容器。還記得上面我們分析源碼的時候,IServiceCollection 裏面注入了很多東西嗎?其實就是往IServiceCollection 這個容器裏面注入方法,這樣其他地方使用的時候就能自動注入了。

這就是容器的好處,由容器來統一管理實例的創建和銷燬,你只需要關心怎麼用就行了,不需要關係怎麼創建跟銷燬。

當然容器創建的實例都是有生命週期的,。下面羅列一下,就不過多的講解了。

  • Transient: 每一次訪問都會創建一個新的實例
  • Scoped: 在同一個Scope內只初始化一個實例 ,可以理解爲( 每一個request級別只創建一個實例,同一個http request會在一個 scope內)
  • Singleton :整個應用程序生命週期以內只創建一個實例

使用的方式也很簡單,我會在接下來的課程中詳細的通過實例來進行講解!因爲現在的例子還沒發演示。

總結

本文一步一步帶着你先分析了ASP.NET Core的啓動過程及運行的原理,緊接着給你講了配置文件的加載過程及原理,並通過示例代碼演示瞭如何加載自定義的配置文件,最後引出了依賴注入以及控制反轉的概念,並通過對我們上面例子的分析來緊身對依賴注入以及控制反轉的理解。至此讓你知其然更知其所以然。對ASP.NET Core的原理相信你已經瞭然於胸了!那麼接下來讓我們再準備下dapper,vue以及git的快速入門就開始我們的asp.net core cms的實戰課程吧!還是那句話基礎很重要,基礎打好,後面才能事半功倍。謝謝大家。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章