溫馨提示×

溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊×
其他方式登錄
點擊 登錄注冊 即表示同意《億速云用戶服務條款》

如何解決swagger2.9.2接口文檔顯示的各種問題

發布時間:2021-06-25 17:39:51 來源:億速云 閱讀:535 作者:chen 欄目:開發技術

這篇文章主要講解了“如何解決swagger2.9.2接口文檔顯示的各種問題”,文中的講解內容簡單清晰,易于學習與理解,下面請大家跟著小編的思路慢慢深入,一起來研究和學習“如何解決swagger2.9.2接口文檔顯示的各種問題”吧!

swagger2.9.2接口文檔顯示

swagger版本:2.9.2

框架:springboot2.1.2

當沒有使用

@ApiImplicitParam和response=Resp.class時,swagger會自動去顯示接口入參對象的各屬性,及響應的對象屬性,如下圖:

如何解決swagger2.9.2接口文檔顯示的各種問題

如何解決swagger2.9.2接口文檔顯示的各種問題

如何解決swagger2.9.2接口文檔顯示的各種問題

而如果加入@ApiImplicitParam和response=Resp.class時,則沒有任務字段屬性顯示,如下:

如何解決swagger2.9.2接口文檔顯示的各種問題

所以建議,當接口的入參為幾個字段屬性時可以加上@ApiImplicitParam進行描述,如果是對象,則只要在該 VO對象用@ApiModel和@ApiModelProperty進行注解后,在接口方法上就不需要加@ApiImplicitParam了,swagger會自動進行解析。

如何解決swagger2.9.2接口文檔顯示的各種問題

Spring Boot整合swagger2.9.2版本出現的小問題

訪問接口文檔地址時,單個應用能正常訪問swagger-ui.html頁面

但F12看到請求接口有報錯:

如何解決swagger2.9.2接口文檔顯示的各種問題

但因為在gateway網關進行了各個服務的接口文檔聚合,所以在gateway訪問時一直報錯,因此最后只能降版本,講到Swagger2.8.0版本。

然后請求時相比2.9.2版本少了兩個請求:

如何解決swagger2.9.2接口文檔顯示的各種問題

這算是2.9.x版本的一個小問題吧,可以看github提交的問題

感謝各位的閱讀,以上就是“如何解決swagger2.9.2接口文檔顯示的各種問題”的內容了,經過本文的學習后,相信大家對如何解決swagger2.9.2接口文檔顯示的各種問題這一問題有了更深刻的體會,具體使用情況還需要大家實踐驗證。這里是億速云,小編將為大家推送更多相關知識點的文章,歡迎關注!

向AI問一下細節

免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。

AI

亚洲午夜精品一区二区_中文无码日韩欧免_久久香蕉精品视频_欧美主播一区二区三区美女