將 .NET Core Console 專案轉換為 ASP.NET Core

console 因為組成簡單、建立快速，常被用來確認語法或是 POC 特定功能需求，不過一旦 POC 沒問題就會遇到程式碼彙總的狀況，如果程式碼數量眾多，要一隻隻程式檔案慢慢搬至目標專案，不僅容易出錯也很沒效率，身為一名懶惰追求高效的開發人員絕對是不允許的，剛好這幾天有個專案有類似需求，順手留個紀錄待日後重新檢視做法 (猜測 .NET Core 3 可能有些不同)

console 專案特性需要使用 Console.ReadLine() 或是 Console.ReadKey() 來讓程式持續運作，在使用上有些限制，所以打算用 ASP.NET Core 來改善

基本環境說明

macOS Mojave 10.14.5
.NET Core SDK 2.2.107 (.NET Core Runtime 2.2.5)
使用之前筆記在 .NET Core console 上使用 Dependency Injection - DI 作為基礎來修改
NuGet package
- Microsoft.AspNetCore 2.2.0

安裝 NuGet 套件： `Microsoft.AspNetCore`

使用 Package Manager
```
Install-Package Microsoft.AspNetCore
```

使用 .NET CLI

dotnet add package Microsoft.AspNetCore

加入 `Startup.cs`

ConfigureServices 方法用來設定應用程式的服務

Configure 方法用來建立應用程式的 request 處理 pipeline

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
    }
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        app.Run(async (context) => { await context.Response.WriteAsync("Hello World!"); });
    }
}

修改 Host 建立方式

使用 builder pattern 建立 Host 並使用 Startup 來設定 service 及 request pipeline

class Program
{
    static void Main(string[] args)
    {
        CreateWebHostBuilder(args).Build().Run();
    }
    public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
        WebHost.CreateDefaultBuilder(args)
           .UseStartup<Startup>();
}

註冊 DI

修改 Startup.cs 的 ConfigureServices

public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<IRunner, YowkoRunner>();
}

使用方式

修改 Startup.cs 的 Configure

方法參數加上 IRunner runner

使用 runner 來執行實際動作

public void Configure(IApplicationBuilder app, IHostingEnvironment env, IRunner runner)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    app.Run((context) => Task.Run(
        () => runner.DoAction(nameof(Startup))));
}

實際效果

直接 access 預設的 url

即可在 console 看到訊息輸出

1consoleoutput

改善console 訊息不明顯

修改 interface 及實作

public interface IRunner
{
    string DoAction(string name);
}
public class Runner : IRunner
{
    public string DoAction(string name)
    {
        return $"Doing hard work! {name}";
    }
}
public class YowkoRunner : IRunner
{
    public string DoAction(string name)
    {
        return $"YowkoRunner : Doing hard work! {name}";
    }
}

修改實際使用

public void Configure(IApplicationBuilder app, IHostingEnvironment env, IRunner runner)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    app.Run(async (context) => { await context.Response.WriteAsync(runner.DoAction(nameof(Startup))); });
}

2pageoutput

心得

雖然原本就知道可能會沒什麼營養，但紀錄完發現真的沒什麼內容XD

不過這是下一則筆記的前言，最終目的是紀錄 gRPC 移至 ASP.NET Core 的作法，避免讓 console 升級 ASP.NET Core 內容影與 gRPC 相關設定混在一起才拆開

完成程式碼請參考 yowko/console2asp.netcore

文章目錄