余小章 @ 大內殿堂

上篇 有提到可以透過 ASP.NET / ASP.NET Core 的 HttpContext 來傳遞狀態，由於他的生命週期很短，每一個調用者擁有獨立的狀態，很適合用來跨層傳遞狀態；現在，我想要降低對 HttpContext 的依賴，改由自訂的 ContextAccessor 保留物件的狀態，傳遞系統所必要的狀態，統一由一個點進行修改，比如登入帳號、追蹤 Id，其他的點，只能取用不能修改。

當我們想要讓物件延遲實例化時，可以透過 Lazy<T> + Delegate 來實現這件事，同樣的在 DI Container 也可以套件，無意間發現 Lazy Proxy 這個套件，可以簡化配置 Lazy 的配置，立馬收入武器內

MongoDB 近幾年來發展的很穩定，也是我心目中 NoSQL 選擇方案之一，對於 .NET 的開發者而言，開發體驗也算是不錯，在這裡我會簡單的分享怎麼建立  .NET + MongoDB 開發環境以及簡單的 CRUD 操作

一直以來都是用 NSwag 來產生 OpenAPI Client & Server Code，但它所產生出來的 Client Code 會 throw Exception，這讓我在商業流程的控制需要額外付出一些心力，為了解決這問題，我會額外再墊一層，最近逛到有人分享 Refit 這個套件，它所產生出來的具名 Method 不會拋出例外，讓我可以根據 HttpStatusCode + Error Content 控制商業流程。

在測試時，TestContainers 它可以簡化我們產生 Container 的步驟，配置 Container 的方式也相當的簡單、明確；從同事得知 TestContainers，周末則來研究一下使用方式。

Exception 是微軟預設中斷流程的手段，要控制好流程就要好好的處理例外，也就是寫 try catch，這會讓流程控制的程式碼看起來很凌亂。於是我需要幾個原則

1. 被流程所呼叫的方法都要處理好 Exception/錯誤(根據需求場景，例如：找不到某個資料) 並回傳 Failure 物件
2. 若有攔截到 Exception，Failure 物件要裝載 Exception 訊息，並且給予該例外正確的錯誤訊息。
3. 盡量在最外層紀錄 Failure 日誌，例如，Controller、Application Layer
4. Web API 回傳值不可以包含 Exception

以上是我的原則，在你的團隊裡面應該也有自己的錯誤處理機制；接下來，我用 ASP.NET Core Web API 實際的演練一遍

微軟一直以來都有提供 Model Validation 讓我們更容易的進行前置條件檢查，這次我想要在 ASP.NET Core Web API 回傳一致性的錯誤結構，捨棄預設錯誤的結構，接下來我將演練 Model Validation 以及 FluentValidation  的使用方式。 

我曾經在端點使用 Dictionary<string,object> 型別，當調用端傳入 {"name":null} 時，移除 name key；傳入 {"name":"123"} 時，name 得的值等於 "123"，這樣便能夠做到類似 Json Path 的功能，參考上篇，在不改變合約的情況之下，這次我想要改用 Morcatko.AspNetCore.JsonMergePatch 來實現更新部分資源並且讓端點的合約變成強型別。

上篇 使用 PowerArgs 解析 Console / WinForm / WPF 的參數 介紹過怎麼通過 PowerArgs 解析參數、綁定行為，這次要用同事介紹的 Spectre.Console，他除了能解析參數轉成強型別之外還有很多華麗的功能，個人認為若是要設計 cli 它比 PowerArgs 來得容易些。

一直以來 Postman 都是我們調用 REST API 的首選，但經過了幾次專案的協作，總是覺得它的功能沒有那麼到位，於是我轉向別的解決方案 Jetbrains 的 Http Client 就是我這一次的標的