最近我們團隊一直進行.net core的轉型,web開發(fā)向著前后端分離的技術架構演進,我們后臺主要是采用了asp.net core webapi來進行開發(fā),開始每次調試以及與前端人員的溝通上都存在這效率低下的問題,一次在看微軟asp.net core官方文檔的時候,發(fā)現(xiàn)了swagger這個好東西。然后在實際的項目中引入了該技術。我們開發(fā)人員測試自己寫的api的過程大大得到了簡化,前端人員也可以根據(jù)我們提供的swagger help pages 自己進行一些前端代碼的測試,大大提高了前后端的開發(fā)效率。下面我就拿我自己的真實上線項目來一步一步的講解如何在asp.net core webapi中引入swagger。(也可以參照微軟官方文檔:https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger)
一、引入swagger Nuget包
右鍵點擊wepapi項目的依賴項,點擊管理Nuget程序包,如下圖:
在打開的NuGet包程序管理界面,輸入:Swashbuckle.AspNetCore 目前該程序包的版本為1.0.0,點擊安裝。
安裝完后,需要在項目中的Startup.cs文件中進行配置。