.net core webapi (2) swagger的高級應用

1. 設置swagger ui頁面爲啓動頁
在前一章的末尾,我們通過在域名後面輸入/swagger後,成功訪問到swagger ui頁,但是我們發現每次運行項目,都會默認訪問api/values這個接口,我想要將啓動頁設爲swagger(或者是你畫好的任一個html頁),那應該怎麼設置呢?

在這裏插入圖片描述

2. 註釋問題
swagger很重要的一個功能,就是將我們接口的註釋信息和參數(包括實體類)的註釋信息顯示到頁面上。

現在我們分別將控制器、函數和參數添加相應的註釋(添加方式是在類或函數的上一行敲三下“/”)

F5運行,發現swagger ui上並沒有將它們顯示出來。那是因爲還缺少兩步

2.1項目生成xml註釋文件
右鍵項目名稱=>屬性=>生成

勾選“輸出”下面的“生成xml文檔文件”,後面填寫保存該文檔的地址(xml文件的名字可以修改,但是不建議修改保存的路徑,然後記住這個地址,待會會用到)

在這裏插入圖片描述

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章