C# 8.0 寶藏好物 Async streams

以前寫《.NET gRPC 核心功能初體驗》，利用gRPC雙向流作了一個打乒乓的Demo，存儲消息的對象是IAsyncEnumerable<T>，這個異步可枚舉泛型接口支撐了gRPC的實時流式通訊。

本文我將回顧分享

• foreach/yield return/async await語法糖的本質
• 如何使用異步流
• 消費異步流時 附加探索

foreach/ yield return/async await的本質

.NET誕生之初，就經過IEnumerable、IEnumerator提供迭代能力，
前者表明具有可枚舉的性質，後者表明可被枚舉的方式。
(看你骨骼驚奇，再送你一本《2021年了，IEnumerable、IEnumerator接口還傻傻分不清楚？》)
若是你真的使用強類型IEnumerable/IEnumerator來產生/消費可枚舉類型，會發現要寫不少瑣碎代碼。

C#推出的yield return迭代器語法糖，簡化了產生可枚舉類型的編寫過程。(編譯器將yield return轉換爲狀態機代碼來實現IEnumerable，IEnumerator)

yield 關鍵字能夠執行狀態迭代，並逐個返回枚舉元素，在返回數據時，無需建立臨時集合來存儲數據。

C#foreach語法糖，簡化了消費可枚舉類型的編寫過程。(編譯器將foreach抓換爲強類型的方法/屬性調用)

IEnumerable src = ...;
IEnumerator e = src.GetEnumerator();
try
{
  while (e.MoveNext()) Use(e.Current);
}
finally { if (e != null) e.Dispose(); }

.NET Framework4引入Task，.NET Framework 4.5/C#5.0引入了await/async異步編程語法糖，簡化了異步編程的編程過程。(編譯器將await/async語法糖轉換爲狀態機，產生Task並在內部回調)

☺️以上也看出微軟爲幫助咱們更快速優雅地編寫代碼，給了不少糖，編譯器作了不少事情。

C#提供了迭代、異步的快捷方式，可否將二者結合？
二者結合的效果就是： 但願在數據就緒時，接受並處理數據，但不會以阻塞CPU的sing是等待，這在lot流式數據中很常見，

異步迭代

有一隻爬蟲要經過列表頁上的連接，抓取連接背後的html內容並顯示。

這是一個[相互獨立的長耗時行爲的集合(假設分別耗時5,4,3,2,1s)]，
咱們使用C#8.0異步可枚舉類型IAsyncEnumerable ，異步產生/消費枚舉元素。

與同步版本IEmunerable 相似，IAsyncEnumerable 也有對應的IAsyncEnumerator迭代器，迭代器的實現過程決定了消費的順序。

C#8.0 Asynchronous streams

C#8.0中一個重要的特性是異步流(async stream), 能夠輕鬆建立和消費異步枚舉。

返回異步流的方法特徵：

• 以async修飾符聲明
• 返回IAsyncEnumerable<T>對象
• 方法包含yield return語句，用來異步持續返回元素

static async Task Main(string[] args)
{
      Console.WriteLine(DateTime.Now + $"\tThreadId:{Thread.CurrentThread.ManagedThreadId}\r\n");

      await foreach (var html in FetchAllHtml())
      {
           Console.WriteLine(DateTime.Now + $"\tThreadId:{Thread.CurrentThread.ManagedThreadId}\t" + $"\toutput:{html}");
      }
      Console.WriteLine("\r\n" + DateTime.Now + $"\tThreadId:{Thread.CurrentThread.ManagedThreadId}\t");
      Console.ReadKey();
 }

 static async IAsyncEnumerable<string> FetchAllHtml()
 {
    for (int i = 5; i >= 1; i--)
    {
        var html = await Task.Delay(i* 1000).ContinueWith((t,i)=> $"html{i}",i);    //  模擬長耗時
        yield return html;
    }
 }

for循環結合yield關鍵字，決定了IAsyncEnymerator的實現;
以上代碼將使得await foreach消費異步枚舉時， 採用與for循環同樣的順序，也就是產生異步任務的前後順序。

以上不會等待15s而後一股腦拋出全部數據，而是根據枚舉for循環，一次就緒，依次顯示，總耗時仍是15s，只不過每一步都是異步的。

附加思考：實現一個更有意思的迭代器

☺️ 可是我心裏想，能不能按照完成異步任務的順序，先完成先消費，這難道不是人之常情，交互體驗應該更好。

static async IAsyncEnumerable<string> FetchAllHtml()
{  
    var tasklist= new List<Task<string>>();
    for (int i = 5; i >= 1; i--)
    {
       var t= Task.Delay(i* 1000).ContinueWith((t,i)=>$"html{i}",i);      // 模擬長耗時任務
       tasklist.Add(t);
    }
    while(tasklist.Any())  
    {
      var tFinlish = await Task.WhenAny(tasklist);
      tasklist.Remove(tFinlish); 
      yield return await tFinlish;
    }
}

上面我先構造了可等待的任務列表，經過Task.WhenAny()按照任務完成的順序 返回迭代。

以上總耗時取決於 耗時最長的那個異步任務5s.

---

.NETCore 3.1 已經能夠在webapi中使用異步流，意味着咱們可將流式數據返回到HTTP響應。

前端也已經有試驗性的Streams API能夠對接消費流式數據。
傳送門: https://developer.mozilla.org/en-US/docs/Web/APs_API
瀏覽器兼容列表: https://developer.mozilla.org/en-US/docs/Web/API_API#browser_compatibility

對於web應用，這着實能提升 可交互性： 想象以前含多個長耗時行爲的列表數據，如今沒必要等待全部數據，，配以loading，誰家完成誰加載，效果槓槓。