第 11 章:非同步 API 設計指南
本章大綱
- 命名與簽名:Async 後綴與取消慣例
- 公開的非同步操作通常應加上
Async後綴 - 支援取消時,提供接受
CancellationToken的多載並一路向下傳遞 - 不要把公開 API 設計成
async void
- 公開的非同步操作通常應加上
- 同步與非同步 API 的取捨
- 規則一:絕對不要包裝非同步來假裝同步
- 規則二:絕對不要包裝同步來假裝非同步
- 結論:優先提供它真正需要的版本
- 例外、取消與逾時語意
- 例外的拋出時機
- 不要把例外當成一般控制流程
- 逾時與取消的區別
ValueTask的適用時機與限制ValueTask的優勢ValueTask的限制
- 函式庫開發者的
ConfigureAwait(false)準則 IAsyncDisposable與自有資源的生命週期- 結語
本章未開放免費試讀,請購買本書以立即閱讀完整版。