當(dāng)你想到ASP.NET Core時，可能會想到Web應(yīng)用程序后端代碼，包括MVC和WebAPI。MVC視圖和Razor頁面還允許使用后端代碼生成帶有HTML元素的前端UI。全新的Blazor更進一步，允許使用WebAssembly在Web瀏覽器中運行客戶端.NET代碼。最后，我們現(xiàn)在有了一個Worker Service應(yīng)用程序的模板。

這是在ASP.NET Core早期預(yù)覽中引入的。雖然項目模板最初列在Web模板下，但此后在向?qū)е兄匦露ㄎ涣艘粋€級別。這是在.NET Core中創(chuàng)建長時間運行的跨平臺服務(wù)的好方法。本文介紹Windows操作系統(tǒng)。

Worker Service項目

在VisualStudio 2019中創(chuàng)建新的Worker Service項目的最快方法是使用最新模板。還可以使用適當(dāng)?shù)腄otNetCLI命令。

啟動VisualStudio并選擇Worker Service模板，如下所示：

要使用命令行，使用以下命令，-o是一個可選標(biāo)志，用于為項目提供輸出文件夾名：

dotnet new worker -o myproject

程序和后臺服務(wù)

Program.cs類包含Main()方法和CreateHostBuilder()方法。這可以在下面的片段中看到：

public class Program
{
 public static void Main(string[] args)
 {
  CreateHostBuilder(args).Build().Run();
 }

 public static IHostBuilder CreateHostBuilder(string[] args) =>
  Host.CreateDefaultBuilder(args)
  .UseWindowsService()
  .ConfigureServices(services =>
  {
   services.AddHostedService<Worker>();
  });
 }

要注意的事情：

1. Main方法調(diào)用CreateHostBuilder()方法，并運行它。

2. 在ASP.NET Core中，WebHostBuilder將被Generic HostBuilder替代。

3. CreateHostBuilder()創(chuàng)建主機并通過調(diào)用AddHostService<T>

Worker.cs，定義如下：

public class Worker : BackgroundService
{
 // ...
 
 protected override async Task ExecuteAsync(CancellationToken stoppingToken)
 {
  // do stuff here
 }
}

要注意的事情：

1. Worker類實現(xiàn)BackgroundService 類，它來自命名空間Microsoft.Extensions.Hoting

2. 然后，Worker類可以重寫ExecuteAsync()方法來執(zhí)行任何長期運行的任務(wù)。

Worker Service 中使用Logging

若要在Worker Service項目中使用日志記錄，可以在Program.cs：

using Microsoft.Extensions.Logging;
public static IHostBuilder CreateHostBuilder(string[] args) =>
 Host.CreateDefaultBuilder(args)
 .UseWindowsService()
 .ConfigureLogging(loggerFactory => loggerFactory.AddEventLog())
 .ConfigureServices(services =>
 {
 services.AddHostedService<Worker>();
 });

1.在使用擴展方法之前，將其NuGet包添加到項目中：

Microsoft.Extensions.Logging.EventLog

2.將適當(dāng)?shù)拿臻g添加到代碼中：

using Microsoft.Extensions.Logging;

3.調(diào)用方法ConfigreLogging()并調(diào)用適當(dāng)?shù)娜罩居涗浄椒?，例如：AddEventLog()。

• AddConsole()
• AddDebug()
• AddEventLog()
• AddEventSourceLogger()
  

這個Worker類通過注入ILogger<Work>對象到構(gòu)造函數(shù)中：

private readonly ILogger<Worker> _logger;

public Worker(ILogger<Worker> logger)
{ 
　　_logger = logger;
}

運行Worker Service

在繼續(xù)之前，請將調(diào)用添加把UseWindowsService()添加到Program類或者確認它已經(jīng)在那里了。官方文檔中UseServiceBaseLifetime()在預(yù)覽版中。在新的版本此方法已重命名為UseWindowsService()中。

public static IHostBuilder CreateHostBuilder(string[] args) =>
  Host.CreateDefaultBuilder(args)
  .UseWindowsService()
  .ConfigureServices(services =>
  {
   services.AddHostedService<Worker>();
  });

根據(jù)代碼文檔，UseWindowsService()進行下列工作：

1. 將主機生存期設(shè)置為WindowsServiceLifetime

2. 設(shè)置 ContentRoot

3. 啟用以應(yīng)用程序名稱作為默認名稱的事件日志記錄。

你可以以各種方式運行Worker Service：

1.在VisualStudio中生成和調(diào)試/運行。

2.發(fā)布到exe文件并運行它

3.運行sc(從Windows\System 32)創(chuàng)建新服務(wù)

若要將Worker Service發(fā)布為具有依賴關(guān)系的exe文件，請運行以下命令：

dotnet publish -o C:\path\to\project\pubfolder

-o參數(shù)可用于指定要生成已發(fā)布文件的文件夾的路徑。它可以是指向項目文件夾的路徑，然后是一個新的子文件夾名，以保存已發(fā)布的文件。

若要創(chuàng)建新服務(wù)，請運行sc.exe從System 32文件夾中傳入從發(fā)布命令生成的exe文件的名稱。

> C:\Windows\System32\sc create MyServiceName binPath=C:\path\to\project\pubfolder\MyProjectName.exe

當(dāng)手動運行服務(wù)時，你將看到以下的日志輸出：

info: WorkerServiceSample.Worker[0] Making doc 1 at: 06/09/2019 00:09:52 -04:00Making your document...
info: WorkerServiceSample.Worker[0] Making doc 2 at: 06/09/2019 00:10:05 -04:00Making your document...
info: Microsoft.Hosting.Lifetime[0]
 Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
 Hosting environment: Development

服務(wù)安裝完成后，會出現(xiàn)在Windows的服務(wù)列表中：

以上就是詳解.NET Core中的Worker Service的詳細內(nèi)容，更多關(guān)于.NET Core中的Worker Service的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論