您好,登錄后才能下訂單哦!
這篇文章主要講解了“如何解決swagger2.9.2接口文檔顯示的各種問題”,文中的講解內容簡單清晰,易于學習與理解,下面請大家跟著小編的思路慢慢深入,一起來研究和學習“如何解決swagger2.9.2接口文檔顯示的各種問題”吧!
swagger版本:2.9.2
框架:springboot2.1.2
@ApiImplicitParam和response=Resp.class時,swagger會自動去顯示接口入參對象的各屬性,及響應的對象屬性,如下圖:
而如果加入@ApiImplicitParam和response=Resp.class時,則沒有任務字段屬性顯示,如下:
所以建議,當接口的入參為幾個字段屬性時可以加上@ApiImplicitParam進行描述,如果是對象,則只要在該 VO對象用@ApiModel和@ApiModelProperty進行注解后,在接口方法上就不需要加@ApiImplicitParam了,swagger會自動進行解析。
訪問接口文檔地址時,單個應用能正常訪問swagger-ui.html頁面
但因為在gateway網關進行了各個服務的接口文檔聚合,所以在gateway訪問時一直報錯,因此最后只能降版本,講到Swagger2.8.0版本。
然后請求時相比2.9.2版本少了兩個請求:
這算是2.9.x版本的一個小問題吧,可以看github提交的問題
感謝各位的閱讀,以上就是“如何解決swagger2.9.2接口文檔顯示的各種問題”的內容了,經過本文的學習后,相信大家對如何解決swagger2.9.2接口文檔顯示的各種問題這一問題有了更深刻的體會,具體使用情況還需要大家實踐驗證。這里是億速云,小編將為大家推送更多相關知識點的文章,歡迎關注!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。