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