您好,登錄后才能下訂單哦!
本篇內容介紹了“如何理解Dotnet Core多路徑異步終止”的有關知識,在實際案例的操作過程中,不少人都會遇到這樣的困境,接下來就讓小編帶領大家學習一下如何處理這些情況吧!希望大家仔細閱讀,能夠學有所成!
一、開始
假設我們有這樣一個API:
客戶端建立連接
有一個SendAsync消息從客戶端發送到服務器
有一個TryReceiveAsync消息,試圖等待來自服務器的消息(服務器有消息發送為True,返之為False)
服務器控制數據流終止,如果服務器發送完最后一條消息,則客戶端不再發送任何消息。
接口代碼可以寫成這樣:
interface ITransport<TRequest, TResponse> : IAsyncDisposable { ValueTask SendAsync(TRequest request, CancellationToken cancellationToken); ValueTask<(bool Success, TResponse Message)> TryReceiveAsync(CancellationToken cancellationToken); }
忽略連接的部分,代碼看起來并不復雜。
下面,我們創建兩個循環,并通過枚舉器公開數據:
ITransport<TRequest, TResponse> transport; public async IAsyncEnumerable<TResponse> ReceiveAsync([EnumeratorCancellation] CancellationToken cancellationToken) { while (true) { var (success, message) = await transport.TryReceiveAsync(cancellationToken); if (!success) break; yield return message; } } public async ValueTask SendAsync(IAsyncEnumerable<TRequest> data, CancellationToken cancellationToken) { await foreach (var message in data.WithCancellation(cancellationToken)) { await transport.SendAsync(message, cancellationToken); } }
這里面用到了異步迭代器相關的概念。如果不明白,可以去看我的另一篇專門討論異步迭代器的文章,【傳送門】。
二、解決終止標志
好像做好了,我們用循環接收和發送,并傳遞了外部的終止標志給這兩個方法。
真的做好了嗎?
還沒有。問題出在終止標志上。我們沒有考慮到這兩個流是相互依賴的,特別是,我們不希望生產者(使用SendAsync的代碼)在任何連接失敗的場景中仍然運行。
實際上,會有比我們想像中更多的終止路徑:
我們可能已經為這兩個方法提供了一個外部的終止令牌,并且這個令牌可能已經被觸發
ReceiveAsync的消費者可能已經通過WithCancellation提供了一個終止令牌給GetAsyncEnumerator,并且這個令牌可能已經被觸發
我們的發送/接收代碼可能出錯了
ReceiveAsync的消費者在數據獲取到中途,要終止獲取了 - 一個簡單的原因是處理收到的數據時出錯了
SendAsync中的生產者可能發生了錯誤
這只是一些可能的例子,但實際的可能會更多。
本質上,這些都表示連接終止,因此我們需要以某種方式包含所有這些場景,進而允許發送和接收路徑之間傳達問題。換句話說,我們需要自己的CancellationTokenSource。
顯然,這種需求,用庫來解決是比較完美的。我們可以把這些復雜的內容放在一個消費者可以訪問的單一API中:
public IAsyncEnumerable<TResponse> Duplex(IAsyncEnumerable<TRequest> request, CancellationToken cancellationToken = default);
這個方法:
允許它傳入一個生產者
通話它傳入一個外部的終止令牌
有一個異步的響應返回
使用時,我們可以這樣做:
await foreach (MyResponse item in client.Duplex(ProducerAsync())) { // ... todo } async IAsyncEnumerable<MyRequest> ProducerAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) { for (int i = 0; i < 100; i++) { yield return new MyRequest(i); await Task.Delay(100, cancellationToken); } }
上面這段代碼中,我們ProducerAsync還沒有實現太多內容,目前只是傳遞了一個占位符。稍后我們可以枚舉它,而枚舉行為實際上調用了代碼。
回到Duplex。這個方法,至少需要考慮兩種不同的終止方式:
通過cancellationToken傳入的外部令牌
使用過程中可能傳遞給GetAsyncEnumerator()的潛在的令牌
這兒,為什么不是之前列出的更多種終止方式呢?這兒要考慮到編譯器的組合方式。我們需要的不是一個CancellationToken,而是一個CancellationTokenSource。
public IAsyncEnumerable<TResponse> Duplex(IAsyncEnumerable<TRequest> request, CancellationToken cancellationToken = default) => DuplexImpl(transport, request, cancellationToken); private async static IAsyncEnumerable<TResponse> DuplexImpl(ITransport<TRequest, TResponse> transport, IAsyncEnumerable<TRequest> request, CancellationToken externalToken, [EnumeratorCancellation] CancellationToken enumeratorToken = default) { using var allDone = CancellationTokenSource.CreateLinkedTokenSource(externalToken, enumeratorToken); // ... todo }
這里,DuplexImpl方法允許枚舉終止,但又與外部終止標記保持分離。這樣,在編譯器層面不會被合并。在里面,CreateLinkedTokenSource反倒像編譯器的處理。
現在,我們有一個CancellationTokenSource,需要時,我們可能通過它來終止循環的運行。
using var allDone = CancellationTokenSource.CreateLinkedTokenSource(externalToken, enumeratorToken); try { // ... todo } finally { allDone.Cancel(); }
通過這種方式,我們可以處理這樣的場景:消費者沒有獲取所有數據,而我們想要觸發allDone,但是我們退出了DuplexImpl。這時候,迭代器的作用就很大了,它讓程序變得更簡單,因為用了using,最終里面的任何內容都會定位到Dispose/DisposeAsync。
下一個是生產者,也就是SendAsync。它也是雙工的,對傳入的消息沒有影響,所以可以用Task.Run作為一個獨立的代碼路徑開始運行,而如果生產者出現錯誤,則終止發送。上邊的todo部分,可以加入:
var send = Task.Run(async () => { try { await foreach (var message in request.WithCancellation(allDone.Token)) { await transport.SendAsync(message, allDone.Token); } } catch { allDone.Cancel(); throw; } }, allDone.Token); // ... todo: receive await send;
這里啟動了一個生產者的并行操作SendAsync。注意,這里我們用標記allDone.Token把組合的終止標記傳遞給生產者。延遲await是為了允許ProducerAsync方法里可以使用終止令牌,以滿足復合雙工操作的生命周期要求。
這樣,接收代碼就變成了:
while (true) { var (success, message) = await transport.TryReceiveAsync(allDone.Token); if (!success) break; yield return message; } allDone.Cancel();
最后,把這部分代碼合在一起看看:
private async static IAsyncEnumerable<TResponse> DuplexImpl(ITransport<TRequest, TResponse> transport, IAsyncEnumerable<TRequest> request, CancellationToken externalToken, [EnumeratorCancellation] CancellationToken enumeratorToken = default) { using var allDone = CancellationTokenSource.CreateLinkedTokenSource(externalToken, enumeratorToken); try { var send = Task.Run(async () => { try { await foreach (var message in request.WithCancellation(allDone.Token)) { await transport.SendAsync(message, allDone.Token); } } catch { allDone.Cancel(); throw; } }, allDone.Token); while (true) { var (success, message) = await transport.TryReceiveAsync(allDone.Token); if (!success) break; yield return message; } allDone.Cancel(); await send; } finally { allDone.Cancel(); } }
“如何理解Dotnet Core多路徑異步終止”的內容就介紹到這里了,感謝大家的閱讀。如果想了解更多行業相關的知識可以關注億速云網站,小編將為大家輸出更多高質量的實用文章!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。