使用Asp.net core webAPI + Swagger搭建web服務的步驟以及問題點

在下從畢業到如今一直都是用微軟的技術棧去開發東西。

asp.net core發佈也有一段時間了，一直沒有去系統的關注一下，最近得閒準備用core的webapi作點東西，也趕上了一些小問題，就把這些東西都記錄下來。

1.建立工程：
這就沒什麼可說了，建立工程這個用VS再簡單不過了，我選的是Api的選項。
core建立web工程會把entityframework直接放到依賴項當中，這個也沒必要細說。

2.配置swaggerui
啓動工程以後，仍是bootstrap的界面，api方法描述也只是描述不能交互，這點仍是挺不方便的。
好在swagger也是能夠應用在.net上的。

如何配置swagger
https://docs.microsoft.com/en...
微軟的這篇文章記述的也是很明白了，你們按圖索驥便可。

有個細節須要注意一下
就是當你們配置好以後

有可能會出現這種500的錯誤，就是加載api描述json失敗，遇到這種狀況，第一反應是要到

console裏面去找信息，反正我遇到的狀況就是controller當中方法共用了一個api地址
致使識別api錯誤。

在這提個醒，下面是正常的圖像。

3.關於EntityFramework
到這一步基本上事兒辦的就差很少了，可是還有一個問題，就是這種狀況下，數據庫仍是沒有準備的狀態
因此若是在這種狀況下，對數據庫進行讀寫操做那就是500等着你。

那麼如今應該幹什麼呢。

照我說的作就OK

1.在工程文件中加入我畫框的這句話

<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="1.0.0" />

2.在此工程文件夾下啓動cmd，執行 dotnet ef migrations add InitialCreate指令

3.用nuget給工程加入Microsoft.EntityFrameworkCore.Tools類庫，這樣我們就能在PMC當中，輸入操做db的指令了

4.執行Update-datebase
成功以後，環境基本就OK了，就能夠繼續開發了。

若是這篇文章對您有幫助，我深表榮幸。