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