一、前言
只是講asp.net core 3.x通用主機的大致原理,這些東西是通過查看原始碼以及自己根據經驗總結得來的,在文章中不會深入原始碼,因為個人覺得懂原理就曉得擴展點,后期碰到有需求的時候再仔細去研究原始碼也不遲,
閱讀前你應該先去了解下(推薦博客園老A的博客):
- asp.net core中的依賴注入、
- 配置,
講解的方式是:
- 概述
- 逐一介紹核心類及擴展方式
- 通常我們如何使用
- 總結
二、概述

以前的控制臺應用程式、winform程式啟動時main首先被執行,后續都是我們自己的代碼來實作框架和業務上的東東,比如我們要使用配置就ConfigurationManager.AppSettings... 若想使用依賴注入則需要引入第三方框架,比如autofact,asp.net framework時代也類似
在.net core 3.0之前的版本默認使用的是IWebHost,它內部定義了IOC容器(服務注冊體現在Startup.ConfigServices),和各種配置源的設定(體現在Program配置主機時),我們后續的Controler、View、包括業務代碼可以很容易做依賴注入和獲取配置資訊(包括運用選項模式)
有時候我們希望寫一個服務,但是這個服務并不是用來做api/web,處理http請求的,比如想做一個物聯網的后端采集服務,一直等待遠端硬體設備提交實時資料過來,后端進行處理,但是又希望使用asp.net core提供的 配置、依賴注入、日志 和其它功能,后來微軟就將asp.net core中的這套東西抽離出來了,叫做通用主機,用來承載任何服務,這些自定義服務中就可以很方便地使用配置、依賴注入、日志、和其它功能,現在asp.net core只是由通用主機承載的其中一種服務,
2.1、默認情況下主要的實作思路是:
2.1.1、定義(微軟定義好的):
- 定義HOST,它包含IOC根容器、主機和應用程式的生命周期事件定定義、IHostedService集合(一個實體就是一個服務或者叫應用,asp.net core就是一個這樣的實體)
- 允許呼叫方提供一堆委托來向IOC中注冊服務、和設定主機和應用的“配置源”
- 提供向主機添加IHostedService的實作物件的方法
- 允許呼叫方注冊主機和應用在啟動和停止階段觸發的相應事件
2.1.2、配置(我們的代碼,微軟定義很多輔助方法):
- 創建IHost實體
- 向Host的IOC容器中注冊各種服務
- 配置主機和應用程式的“配置源
- 向主機內部添加IHostedService實體(也就是我們最終的服務)
- 主機和應用的生命周期事件,來實作一些特殊任務
2.1.3、啟動階段(微軟定義好的)
- 上面所謂的配置基本都是通過委托實作的(通常微軟提供的各種擴展方法最終也是執行委托),回呼這些委托以設定“配置源”和注冊服務
- 最后遍歷啟動HostedService
- 在啟動程序中還會回呼相應的生命周期事件
2.2、啥是應用?
上面提了幾次“應用”,現在對于主機來說asp.net core框架就是一個應用、我們上面舉例說的"物聯網后端服務"是另一個應用,從代碼上來說就是一個IHostedService的實作,
主機和應用是一對多的關系,多個應用可以共享主機的資訊,如:主機的IOC容器、主機的配置,應用配置,應用當然也可以自己去創建自己的IOC根容器和配置物件
主機配置和應用配置有關系?這兩個配置物件都存在于Host中,主機配置是只跟主機相關的配置,應用配置是主機中多個應用共享的配置,如果主機中只有一個應用,那么完全可以拿它做最終的應用配置,另外應用配置包含主機配置
注意:在理解時要記住我們現在的目的是講解通用主機,意思是可以承載你自己定義的服務的主機,別去想什么mvc controller action 路由之類的
三、核心類
下面分別介紹下主機中的幾個核心默認實作類,幾乎每個類都有對應的介面,為了縮短篇幅、便于理解就不講介面了,
3.1、Host
它代表主機,用來宿主(承載)我們應用(一個IHostedService的實作),
主要包含:日志、主機和應用的生命周期事件、IOC根容器、主機的選項物件、啟動停止/停止方法,
介面中只定義了:IOC根容器 + Start + Stop方法
它在Program.Main中被創建、配置和啟動
默認實作Microsoft.Extensions.Hosting.Internal.Host,它是一個internal的類,這個主機將來被啟動時:
- 觸發主機的WaitForStartAsync事件
- 逐一啟動主機內部的hostedService
- 觸發_applicationLifetime?.NotifyStarted();事件
- 停止時就反過來,先逐一停止hostedService,觸發回應事件、最后停止主機
擴展:
因為默認Host是internal修飾的,所以無法繼承
- 自定義實作IHost;(這不說了,你可以隨心所欲)
- 訂閱主機和應用的生命周期事件(實作IHostLifetime、IHostApplicationLifetime并添加到IOC容器)
大部分情況下方式2實作起來更容易也更常見
提一嘴,asp.net core 3.x現在也是使用的這個默認主機,只是在上面做了根web相關的配置,將在下一篇講解
3.2、HostBuilder
Host的職責只是完成主機該有的功能,那么它的創建及配置最好另外定義一個類HostBuilder,它是Host的創建器(工廠),我們通常
- 在系統啟動時(Program.Man)先創建HostBuilder,
- 然后進行配置(向IOC容器注冊服務,設定主機和應用的"配置源"),
- 最后呼叫Build方法生成我們最終的Host
通過介面IHostBuilder原始碼可以初略看出它(通過委托的方式)提供以下功能
- 設定主機和應用的“配置源”
- 配置IOC容器本身
- 想IOC容器添加服務
- 創建Host
- 有個Properties屬性,是個字典型別,可以在構建Host的多個步驟中傳遞資料
擴展:
對于我們使用者來說主要是通過它的方法向內部塞入各種委托,以達到向IOC容器注冊服務和設定主機和應用的“配置源”
也可以但估計很少去實作主機的IHostBuilder;繼承HostBuilder意義也不大,因為它沒有提供抽象和虛方法
默認Build流程
初始化主機配置物件IConfiguration,主要是回呼,主機沒有做其它的
初始化主機環境物件_hostingEnvironment
- 應用程式名字從上一步的主機配置里來
- 環境名(開發?除錯?)從配置里來,若沒有則默認是生產模式"Production"
- 內容根也從配置里來,若沒有則是當前程式路徑
- 根據內容跟創建一個ContentRootFileProvider 實作類是PhysicalFileProvider
初始化HostBuilderContext,根據上面的配置和環境創建這個背景關系(這里只是暫時用的主機配置,下面會被替換成應用的配置)
初始化應用配置
- 以上面的內容根作為配置查找的根(若將來提供物理檔案作為配置源時需要此屬性)
- 將主機配置塞入這個應用配置,所以應用配置=主機配置+回呼后的配置
- 最后將HostBuilderContext的Configuration替換為此配置物件
創建IOC容器
- 創建ServiceCollection,并將上面的幾個物件以單利模式放入進去
- 還要放入IHostApplicationLifetime和IHostLifetime和Host
- 開啟選項模式,注冊日志
- 回呼configureServicesAction
- 呼叫工廠_serviceProviderFactory創建ServiceProvider
- 回呼_configureContainerActions
- 最后回傳容器
呼叫容器決議并回傳Host
3.3、HostBuilder的工廠方法Host.CreateDefaultBuilder
上面有了Host,也有了對應的創建器HostBuilder,為啥還要再提供一個工廠方法呢?
因為職責分離原則,Host只負責承載應用并提供容器和設定配置源;HostBuilder只是負責配置并創建Host,盡可能提供一些默認值(前提時將來呼叫方未提供那些引數),此時我們可以直接用HostBuilder來創建Host并啟動它,但別忘了.net core是一個通用框架,它應提供一個更簡潔的方式來創建最終的Host,因此它提供了靜態方法Host.CreateDefaultBuilder,它盡可能提供更多的默認值,核心任務如下:
- new HostBuilder
- 設定程式的當前目錄為內容根
- 為主機配置 設定 環境變數作為配置源(只關注前綴DOTNET_的環境變數)
- 為應用配置設定 以“appsettings.json”和“appsettings.{env.EnvironmentName}.json”作為配置源;同時也將環境變數加入到應用的配置源;最后將命令列引數加入到配置源
- 配置日志
- 若是開發模式,還會配置依賴注入的范圍驗證
四、從使用者的角度來說
通過自定義實作IHostedService的類來實作我們的服務,我們的服務中的類可以
- 直接使用依賴注入,
- 也可以通過依賴注入獲取主機配置和全域應用配置物件,或者更方便的是進一步使用選項模式
- 我們也可以注入日志記錄器
- 由于主機創建程序的相關資料幾乎都放進了IOC容器中,因此我們也可以通過依賴注入拿到
- 其它...
在Program.man呼叫Host.CreateDefaultBuilder,如果需要,提供相應的委托來注冊服務和設定主機和應用的“配置源”,最好是通過相關擴展方法和自定義擴展方法,重點是記得注入我們自己的服務實作類
五、總結
.net core為我們提供了新的承載應用(包括但不僅限于asp.net core)的方式-->通用主機,通過它我們可以很容易的在自己的應用中使用依賴注入、配置、日志等,你可以發揮想象實作很多牛B的框架,
asp.net core 3.x開始默認也是使用它來承載的
核心的Host、HostBuilder、Host.CreateDefaultBuilder實作了通用主機,并提供了擴展點
最后我想說如果在.net core上提供一個默認的aop方案就更完美了,
下一篇試試說下asp.net core是如何承載到通用主機上的

轉載請註明出處,本文鏈接:https://www.uj5u.com/net/75384.html
標籤:.NET Core
