前言

上一篇博客中我們可以得知通過Swagger插件可以很方便的提供給介面開發者在線調試，但是實際上Swagger附帶的功能還有很多，

比如使用NSwag生成客戶端調用代碼，進一步解放介面開發者。

NSwag

NSwag是一個發布在GitHub上的開源項目，它可以根據Swagger說明頁上的swagger.json文件生成C#、TypeScript客戶端代碼。

NSwag的項目地址:https://github.com/RSuter/NSwag

Nswag提供4種代碼生成方法

1、使用 NSwagStudio，這是一款 Windows 桌面應用，用於在 C# 和 TypeScript 中為 API 生成客戶端代碼。

2、使用 NSwag.CodeGeneration.CSharp 或 NSwag.CodeGeneration.TypeScript NuGet 包在項目中執行代碼生成。

3、使用命令行中的 NSwag。

4、使用 NSwag.MSBuild NuGet 包。

這裡推薦使用NSwagStudio，可以從GitHub上下載該工具，地址:https://github.com/RSuter/NSwag/wiki/NSwagStudio

下載後開始安裝，安裝完畢後打開NSwagStudio，如下圖，在左側選擇Tab頁菜單里選擇Documents

如上圖框框選中的幾點，我們需要留意。其中Swagger Specification URL就是我們WebAPI的swagger.json的在線地址。

如果點擊【Create local Copy 】按鈕時你的WebAPI未在線則代碼生成工具會彈出錯誤對話框，如下圖:

所以採取讀取Swagger Specification URL 方式進行生成代碼的前提條件是你必須保證swagger.json文件能在線讀取！

其次你可以選擇RunTime（運行時），這裡應該是服務端WebAPI的運行時(畢竟TypeScript是不關心你服務端是.NET Core還是.NET Framework).

因為我的環境是.NET Core2.1，所以這裡選擇NET Core21。

接下來，點擊【Create local Copy】按鈕，點擊後NSwagStudio會與WebAPI服務端進行交互，成功後會將swagger.json文件格式化到左邊的文本編輯器中，如下圖:

此時，你可以在右側的Outputs中勾選你需要輸出的文件格式，這裡我選擇TypeScript和CSharp Client，

這個地方有個C# WebAPI Controller，我有點納悶，我都有swagger.json文件了絕壁是已經存在webapi了，

沒有必要反向再去生成一遍webapi的控制器啦。 不懂，反正只管生成客戶端代碼就好。

我們勾選好後下面就會出現相應的輸出配合頁面，如下圖:

我們選擇CSharp Client頁面，該頁面左側分為Setting和Output兩個頁面，Setting頁可以對輸出的cs文件進行配置，如命名空間、類名稱、輸出文件路徑等等(很多配置我也不會....)

我們點擊【Generate Outputs】後NSwagStudio會根據配置生成客戶端操作類，在Output頁面即可檢查，檢查無誤後再點擊【Generate Files】可將類文件導出到配置的輸出目錄。

TypeScript亦是如此，同時NSwagStudio也可支持載入DLL反射生成，具體方法可根據官網操作(畢竟可以直接使用json文件在線生成沒必要再自己手工選擇dll..)

這裡截圖看SwagerUI頁和NSwagStudio生成後的客戶端cs文件

生成的客戶端C#代碼：

喜歡這篇文章嗎？立刻分享出去讓更多人知道吧！