余小章 @ 大內殿堂

Dapper.Contrib 另外提供 CRUD 的擴充方法，針對 IDbConnection 型別進行擴充，他會根據 Model 定義自動幫我們渲染 SQL 語句，對於簡單的 CRUD 情境相當合用，從原本需要 Insert Command 以及 Parameter 的寫法，變成只需要 Insert(Model)

本以為這是一個很簡單的題目，但由於我是用 OWin，所以只要依賴 HttpContext.Current 就無法使用，花了一些時間整理出不透過 HttpContext.Current 上傳檔案的用法

原本一直在使用的 Swashbuckle 原來已經不更新，讓下載檔案的功能不正常，改用 Swagger-Net 就可以解決這個問題囉

以前曾經使用過Nuget V2 (NuGet.Core)來操作 nuget，因為需要所以改用 V3，這裡就紀錄使用方式

OAuth2 是目前大廠都有支援的一種授權機制， Swagger 也有支援，我將使用  Resource Owner Password / Implicit flow + Identity Framework 來進行演練。

前面幾篇寫了使用 Swagger 的方式，這篇記錄一下編寫文件的技巧以及支援 Client Code Gen 幾種方式

Swagger UI 上方有一個 api_key，這次我要利用他加上 JWT 來驗證

通常 API 都會經過保護， 當 API 需要授權才能使用時，Swagger 就需要做一些調整才能正常的調用，設定好 Basic Auth 就會有驗證對話視窗

來看看怎麼完成的吧

預設的情況，Web API 想要用相同的 ClassName 不同的 Namespace 來當成版本 URI 是不行的，幸好這件事不難官方也有提供解法

https://blogs.msdn.microsoft.com/webdev/2013/03/07/asp-net-web-api-using-namespaces-to-version-web-apis/

搬到 Swagger 也不難，只是有一些坑需要踩..
 

Swagger 是個不錯的文檔+測試工具，但是卻不支援多個行為，需要靠它來簡化文件的工作，怎麼辦?