解決swagger2.9.2接口文檔顯示的問題
swagger2.9.2接口文檔顯示
swagger版本:2.9.2
框架:springboot2.1.2
當(dāng)沒有使用
@ApiImplicitParam和response=Resp.class時(shí),swagger會(huì)自動(dòng)去顯示接口入?yún)?duì)象的各屬性,及響應(yīng)的對(duì)象屬性,如下圖:
而如果加入@ApiImplicitParam和response=Resp.class時(shí),則沒有任務(wù)字段屬性顯示,如下:
所以建議,當(dāng)接口的入?yún)閹讉€(gè)字段屬性時(shí)可以加上@ApiImplicitParam進(jìn)行描述,如果是對(duì)象,則只要在該 VO對(duì)象用@ApiModel和@ApiModelProperty進(jìn)行注解后,在接口方法上就不需要加@ApiImplicitParam了,swagger會(huì)自動(dòng)進(jìn)行解析。
Spring Boot整合swagger2.9.2版本出現(xiàn)的小問題
訪問接口文檔地址時(shí),單個(gè)應(yīng)用能正常訪問swagger-ui.html頁(yè)面
但F12看到請(qǐng)求接口有報(bào)錯(cuò):
但因?yàn)樵趃ateway網(wǎng)關(guān)進(jìn)行了各個(gè)服務(wù)的接口文檔聚合,所以在gateway訪問時(shí)一直報(bào)錯(cuò),因此最后只能降版本,講到Swagger2.8.0版本。
然后請(qǐng)求時(shí)相比2.9.2版本少了兩個(gè)請(qǐng)求:
這算是2.9.x版本的一個(gè)小問題吧,可以看github提交的問題
以上為個(gè)人經(jīng)驗(yàn),希望能給大家一個(gè)參考,也希望大家多多支持腳本之家。
相關(guān)文章
springboot從application.properties中注入list,?map方式
這篇文章主要介紹了springboot從application.properties中注入list,map方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-11-11Mybatis模糊查詢之三種定義參數(shù)方法和聚合查詢、主鍵回填實(shí)現(xiàn)方法
這篇文章主要介紹了Mybatis模糊查詢之三種定義參數(shù)方法和聚合查詢、主鍵回填實(shí)現(xiàn)方法,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2023-03-03Java如何使用itext向PDF插入數(shù)據(jù)和圖片
最近項(xiàng)目中使用到Java實(shí)現(xiàn)寫入PDF文件,這篇文章主要給大家介紹了關(guān)于Java如何使用itext向PDF插入數(shù)據(jù)和圖片的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-01-01詳解SpringBoot健康檢查的實(shí)現(xiàn)原理
這篇文章主要介紹了詳解SpringBoot健康檢查的實(shí)現(xiàn)原理,幫助大家更好的理解和學(xué)習(xí)使用SpringBoot框架,感興趣的朋友可以了解下2021-03-03Java多線程定時(shí)器Timer原理及實(shí)現(xiàn)
這篇文章主要介紹了Java多線程定時(shí)器Timer原理及實(shí)現(xiàn),涉及Timer的schedule的使用,定時(shí)器Timer的schedule等相關(guān)內(nèi)容以及代碼示例,具有一定參考價(jià)值,需要的朋友可以了解下。2017-11-11