ASP.NET Core 練習 - 非同步化

繼續練習寫 ASP.NET Core 的正確姿勢。

除了在 ASP.NET Core 無所不在的 DI，另一個跨進 .NET Core 要習慣的轉變是 - async/await 非同步化! 延伸閱讀： ASP.NET async 基本心法

.NET 已逐漸走向非同步化。以 ViewComponent 介面為例，規格便要求檢視元件方法 需 Task<IViewComponentResult> InvokeAsync 或 IViewComponentResult Invoke 二者擇一，開發者可以選擇寫非同步版 InvokeAsync 或是同步化版本 Invoke。我選擇過去較熟悉的同步寫法，但寫起來不順，原因是新一代的 HttpClient 元件提供的方法全是 async 版!

雖然加個 .Result 就可以將非同步方法轉為同步化(註：更完美的做法是 GetAwaiter().GetResult())，但這讓我產生自己正在抵抗潮流的不安感，還是把 Invoke 改寫成 InvokeAsync 吧!

第一步，先將 WeatherBlockViewComponent 的 Invoke() 改成 public async Task<IViewComponentResult> InvokeAsync(string zoneName)：

出現綠蚯蚓警告，提示我們 async 方法中缺少了 await，因此我們得把 IWeatherService.GetWeatherData 改成 async 版，呼叫時就能加上 await。

    public interface IWeatherService
    {
        //WeatherData GetWeatherData(string zoneName);
        Task<WeatherData> GetWeatherDataAsync(string zoneName);
    }

介面修改了，實作 IWeatherService 的 SimpleWeatherService 要跟著修改：

public Task<WeatherData> GetWeatherDataAsync(string zoneName)
{
    return GetWeatherFromOpenDataApi(zoneName);
}

public async Task<WeatherData> GetWeatherFromOpenDataApi(string zoneName)
{
    var resp = await httpClient.GetAsync(openDataApiUrl);
    resp.EnsureSuccessStatusCode();
    var json = await resp.Content.ReadAsStringAsync();       
    using (var doc = JsonDocument.Parse(json,
        new JsonDocumentOptions { AllowTrailingCommas = true }))
    //...以下省略

GetWeatherFromOpenDataApi 改回傳 Task<WeatherData> 並宣告為 async，內部呼叫 HttpClient .GetAsync()、ReadAsStringAsync() 可加 await。回頭再修改 WeatherBlockViewComponent 寫成 var data = await _weatherService.GetWeatherDataAsync(zoneName);，整串非同步化修改才完成。這個案例也算展示了 async 病毒式的感染性 - 一沾到 async，上下游都要跟著改。

public async Task<IViewComponentResult> InvokeAsync(string zoneName)
{
    var data = await _weatherService.GetWeatherDataAsync(zoneName);
    return View(data);
}

執行結果不變，但骨子裡程式已經非同步化，在相同硬體環境可達到更高的產能。

最後補充一個小訣竅 - 在 DI 練習中有個只傳回 new WeatherData() 的 FakeWeatherService，是道道地地的同步化程序，現在 IWeatherService 介面改成 async 版，純同步化程式要怎麼改成非同步化？

請愛用 Task.FromResult<T>：

public Task<WeatherData> GetWeatherDataAsync(string zoneName)
{
    return Task.FromResult<WeatherData>(new WeatherData
    {
        ZoneName = zoneName,
        Status = "冰雹龍捲風",
        MinTemp = "-18",
        MaxTemp = "38"
    });
}

要特別提醒，由於這個程序不包含任何非同步動作，純粹為了符合介面規格，FakeWeatherService 的 GetWeatherDataAsync 不用加上 async，也不要 await Task.FromResult，加了程式照樣可跑，但沒任何好處只浪費 100 Byte。

Example of changing the methods in ASP.NET Core from sync to async.