簡介

對于.net來說，用web api來構建服務是一個不錯的選擇，都是http請求，調用簡單，但是如果真的要在程序中調用，則還有些工作要做，比如我們需要手寫httpClient調用，并映射Model， 如果服務少還可以，多了就繁瑣了。

Swagger

關于Swagger的信息，其他博客已經有介紹，這里就不多說。 大家可以參考http://chuansong.me/n/322685748559?，使用Swagger后，可以解決服務沒有文檔或者文檔和服務不同步的問題，同時Swagger自帶的就有模擬請求的功能，所以可以在頁面上直接測試接口。 這些不僅對開發，對測試同學也是友好的。? 下面是一個簡單的Web API,添加注釋 引用swagger后，訪問http://XXX/swagger/ui/index(XXX為你的域名)，結果如下，可以看到頁面上會顯示你的服務，以及服務的描述。 點擊具體某個服務，你可以看到你定義的參數，并可以直接在頁面上發起測試。?

AutoRest

有了Swagger后，方便查看服務，接下來就是如何調用服務，過往我們通常會寫一個HttpUtils的類，里面包含SendGet，SendPost兩個方法，如果是簡單參數還好，但是如果Get請求返回一個對象，或者Post的時候需要發送一個對象，則需要手寫這些類進行封裝。 這里介紹一個組件:AutoRest (https://github.com/Azure/AutoRest), 簡單來說，就是一個EXE工具，可以根據Swagger的結構生成服務的客戶端，這個客戶端可以讓你像調用本地方法一樣調用服務，方法內部包裝了Http請求。? 在Swagger頁面，你可以點擊Explore按鈕，通過瀏覽器可以看到這里返回了一個Json字符串，頁面也是根據這個字符串進行的渲染，AutoRest也是根據這個結構來生成調用類。 選擇Nuget，下載AutoRest 在solution下面找到pageage文件夾，目錄如下： 在命令行里面打開 ，輸入如下?AutoRest.exe -CodeGenerator CSharp -Modeler Swagger -Input http://XXX/swagger/docs/v1 -Namespace UserServiceClient, 其中Input的參數就是Swagger的Json地址，具體參數含義可以查看文檔。? 執行成功后，在當前目錄下會生成一個Generated目錄 打開文件如下： 新建一個控制臺程序，將整個文件夾copy到控制臺程序下，文件夾名稱可以隨意定義。 同時控制臺程序需要在Nuget中引用一個Client.? 寫代碼，調用，同時支持同步接口和異步接口。? 至此，全部完成。?

總結

1. 以上這種方式，可以由服務端的同學完成，然后將生成的代碼，簡單修改后，編譯發布到公司內nuget上，其他同學可以直接到公司內nuget下載 2. 服務端同學可以只集成Swagger，然后其他同學如果要用，可以通過工具生成。? 3.?以上僅是公司再未使用RPC前,方便服務調用的一種方式。 后面我會介紹一些.Net下的其他的服務調用方式，比如Hession,serverstack 分類:?服務調用

總結

以上是生活随笔為你收集整理的Swagger+AutoRest 生成web api客户端(.Net)的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。