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