什么是Generic Host ?
這是在Asp.Net Core 2.1加入了一種新的Host，現在2.1版本的Asp.Net Core中，有了兩種可用的Host。
- Web Host –適用於托管Web程序的Host,就是我們所熟悉的在Asp.Net Core應用程序的Mai函數中用CreateWebHostBuilder創建出來的常用的WebHost。
- Generic Host (ASP.NET Core 2.1版本才有) – 適用於托管非 Web 應用（例如，運行后台任務的應用）。 在未來的版本中，通用主機將適用於托管任何類型的應用，包括 Web 應用。 通用主機最終將取代 Web 主機，這大概也是這種類型的主機叫做通用主機的原因，在本博客中，我們將結合源碼，討論通用主機的工作原理。
為什么要用通用主機？
通用主機，讓我可以用編寫Asp.Net Core的思想（例如控制反轉、依賴注入、IOC容器）來簡化控制台應用程序的創建（個人見解），主機負責程序的啟動和生存周期的管理，這對於不處理HTTP請求的應用程序非常有用（處理HTTP請求的是Web應用程序，用Web Host托管），通用主機的目標是將HTTP管道從Web Host中脫離出來，使得Asp.Net Core的那套東西也適用於其他.Net Core程序。
Demo下載
在開始跟隨我分析通用主機之前，大家可以到Github下載這個官方Demo。
https://github.com/aspnet/Docs/tree/master/aspnetcore/fundamentals/host/generic-host/samples/
如果覺得下載一整個比較慢，可以從我的這個Github倉庫下載，沒有其他多余內容，國內Github比較慢，如果你從官方那個倉庫下載可能會需要很長時間甚至失敗。
https://github.com/liuzhenyulive/Generic-Host-Demo
Generic Host 和Web Host 對比
首先，大家打開下載下來的這個官方Demo,進入Main函數。
可以看到，這簡直就是一個精簡版的Asp.Net Core應用程序，對這個Main函數中出現的所有方法，大家對Asp.Net Core Web應用程序比較熟悉，所以我與Asp.net core 的Webhost做了一個對比，來幫助大家找找感覺。
| 通用主機 | Web主機 |
| new HostBuilder() | WebHost.CreateDefaultBuilder(args) |
| ConfigureAppConfiguration (用於配置Configuration) |
WebHost也有這個方法，只是大家默認可能沒有調用。 |
| ConfigureServices (用於配置Service，也就是依賴注入) |
WebHost其實也有ConfigureServices方法，可以這么調用。 但是我們一般很少這么用，一般都是放在Startup的ConfigureServices方法中進行依賴注入。 |
| ConfigureLogging (是本應用程序所需要的配置，非必需） |
WebHost還是有！ |
builder.RunConsoleAsync() RunConsoleAsync中其實是對hostbuilder進行 Builder然后Run |
CreateWebHostBuilder(args).Build().Run(); 也就是Main函數中的Build().Run(); |
無無無無 |
Startup中的Configure()方法 Asp.net core在此方法中進行Http請求管道的配置 |
綜上對比，我做了如下概括！
- 通用主機（Generic Host）有的 Web Host都有。
- Web Host的Http Pipeline即Startup.Configure() 在通用主機中沒有。
這就應證了開頭所說的：通用主機的目標是將HTTP管道從Web Host中脫離出來，使得Asp.Net Core的那套東西也適用於其他.Net Core程序。
如何使用？
Run函數解讀
我覺得要知道怎么用，那么我們就首先要知道Host的Run方法內到底是在執行什么？
所以我們深入源碼，一路F12!
builder.RunConsoleAsync(); =>hostBuilder.UseConsoleLifetime().Build().RunAsync(cancellationToken);=> await host.StartAsync(token);
總算找到了，最關鍵的在這里。
public async Task StartAsync(CancellationToken cancellationToken = default (CancellationToken)) { this._logger.Starting(); TaskCompletionSource<object> completionSource1 = new TaskCompletionSource<object>(); ref CancellationToken local = ref cancellationToken; TaskCompletionSource<object> completionSource2 = completionSource1; local.Register((Action<object>) (obj => ((TaskCompletionSource<object>) obj).TrySetCanceled()), (object) completionSource2); IHostLifetime hostLifetime1 = this._hostLifetime; TaskCompletionSource<object> completionSource3 = completionSource1; hostLifetime1.RegisterDelayStartCallback((Action<object>) (obj => ((TaskCompletionSource<object>) obj).TrySetResult((object) null)), (object) completionSource3); IHostLifetime hostLifetime2 = this._hostLifetime; ApplicationLifetime applicationLifetime = this._applicationLifetime; hostLifetime2.RegisterStopCallback((Action<object>) (obj => (obj as IApplicationLifetime)?.StopApplication()), (object) applicationLifetime); object task = await completionSource1.Task;this._hostedServices = this.Services.GetService<IEnumerable<IHostedService>> (); foreach (IHostedService hostedService in this ._hostedServices) await hostedService.StartAsync(cancellationToken).ConfigureAwait(false
); this._applicationLifetime?.NotifyStarted(); this._logger.Started(); }
知道大家都喜歡Yellow色，所以我用Yellow把最關鍵的代碼標示出來了，那么這些代碼有什么含義呢？
this._hostedServices = this.Services.GetService<IEnumerable<IHostedService>>();
這一行的意思是，從容器中取出所有實現了IHostedService的服務。
這就意味着，我們實現了IHostedService后，需要把該Service注冊到IOC容器中。
foreach (IHostedService hostedService in this._hostedServices)
await hostedService.StartAsync(cancellationToken).ConfigureAwait(false);
執行每個服務的StartAsync方法。
所以，大家是不是冥冥中猜到了怎么用的呢？
我總結的步驟如下：
- 自定義一個Service,繼承 IHostedService接口。
- 實現 IHostedService的StartAsync方法，把需要執行的任務放到這個方法中。
- 把該服務注冊到IOC容器（ServiceCollection）中。
自定義任務的運行
對於步驟1和2,對應的代碼如下：
public class PrintTextToConsoleService : IHostedService, IDisposable { private readonly ILogger _logger; private readonly IOptions<AppConfig> _appConfig; private Timer _timer; public PrintTextToConsoleService(ILogger<PrintTextToConsoleService> logger, IOptions<AppConfig> appConfig) { _logger = logger; _appConfig = appConfig; } public Task StartAsync(CancellationToken cancellationToken) { _logger.LogInformation("Starting"); _timer = new Timer(DoWork, null, TimeSpan.Zero, TimeSpan.FromSeconds(5)); return Task.CompletedTask; } private void DoWork(object state) { _logger.LogInformation($"Background work with text: {_appConfig.Value.TextToPrint}"); } public Task StopAsync(CancellationToken cancellationToken) { _logger.LogInformation("Stopping."); _timer?.Change(Timeout.Infinite, 0); return Task.CompletedTask; } public void Dispose() { _timer?.Dispose(); } }
可以看到，在StartAsync中，定義了一個定時任務，帶定時任務每五秒執行一次DoWork方法。
在DoWork方法中，日志記錄器記錄了一段內容。
因為在Main方法中，對Log進行了如下的配置。
所以，一旦日志記錄了內容，該內容就會在控制台中輸出。
對於步驟3,對應的代碼如下
public static async Task Main(string[] args) { var builder = new HostBuilder() //實例化一個通用主機 .ConfigureAppConfiguration((hostingContext, config) => { config.AddJsonFile("appsettings.json", optional: true); config.AddEnvironmentVariables(); if (args != null) { config.AddCommandLine(args); } }) //配置Configuration .ConfigureServices((hostContext, services) => { services.AddOptions(); services.Configure<AppConfig>(hostContext.Configuration.GetSection("AppConfig")); services.AddSingleton<IHostedService, PrintTextToConsoleService>
(); }) //配置Service （依賴注入） .ConfigureLogging((hostingContext, logging) => { logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging")); logging.AddConsole(); }); //配置Log （本項目中要利用Log把內容在控制台輸出） await builder.RunConsoleAsync(); //在控制台應用程序中運行通用主機 }
黃色部分，把實現了IHostedService接口的PrintTextToConsoleService注冊到容器中。
F5 運行
可以看到，控制台中，每五秒就有一次內容輸出，說明DoWork方法沒五秒被執行了一次，也說明PrintTextToConsoleService的StartAsync被成功調用了。
希望本文對幫助大家理解通用主機能夠有所幫助，如果對.Net Core的源碼分析、潮流新技術感興趣
歡迎關注我
不定期推出實用干活，謝謝！
參考文獻
https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/host/generic-host?view=aspnetcore-2.1