解決swagger2.9.2接口文檔顯示的問(wèn)題
swagger2.9.2接口文檔顯示
swagger版本：2.9.2
框架：springboot2.1.2
當(dāng)沒(méi)有使用
@ApiImplicitParam和response=Resp.class時(shí)，swagger會(huì)自動(dòng)去顯示接口入?yún)?duì)象的各屬性，及響應(yīng)的對(duì)象屬性，如下圖：
而如果加入@ApiImplicitParam和response=Resp.class時(shí)，則沒(méi)有任務(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)的小問(wèn)題
訪問(wèn)接口文檔地址時(shí)，單個(gè)應(yīng)用能正常訪問(wèn)swagger-ui.html頁(yè)面
但F12看到請(qǐng)求接口有報(bào)錯(cuò)：
但因?yàn)樵趃ateway網(wǎng)關(guān)進(jìn)行了各個(gè)服務(wù)的接口文檔聚合，所以在gateway訪問(wèn)時(shí)一直報(bào)錯(cuò)，因此最后只能降版本，講到Swagger2.8.0版本。
然后請(qǐng)求時(shí)相比2.9.2版本少了兩個(gè)請(qǐng)求：
這算是2.9.x版本的一個(gè)小問(wèn)題吧，可以看github提交的問(wèn)題
以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。
相關(guān)文章
Java的ConcurrentLinkedQueue源碼分析
這篇文章主要介紹了Java的ConcurrentLinkedQueue源碼分析,ConcurrentLinkedQueue 是一個(gè)基于鏈接節(jié)點(diǎn)的無(wú)界線程安全的隊(duì)列,當(dāng)我們添加一個(gè)元素的時(shí)候,它會(huì)添加到隊(duì)列的尾部,當(dāng)我們獲取一個(gè)元素時(shí),它會(huì)返回隊(duì)列頭部的元素,需要的朋友可以參考下2023-12-12
java獲取文件擴(kuò)展名的方法小結(jié)【正則與字符串截取】
這篇文章主要介紹了java獲取文件擴(kuò)展名的方法,結(jié)合實(shí)例形式分析了使用正則與字符串截取兩種獲取擴(kuò)展名的操作技巧,需要的朋友可以參考下2017-01-01
springboot整合shardingsphere和seata實(shí)現(xiàn)分布式事務(wù)的實(shí)踐
本文主要介紹了springboot整合shardingsphere和seata實(shí)現(xiàn)分布式事務(wù)的實(shí)踐，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2022-07-07
SpringMVC接收java.util.Date類型數(shù)據(jù)的2種方式小結(jié)
這篇文章主要介紹了使用SpringMVC接收java.util.Date類型數(shù)據(jù)的2種方法，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2021-08-08
這篇文章主要介紹了如何使用MAVEN打JAR包(直接使用),文中通過(guò)實(shí)例代碼介紹了maven?使用assembly插件進(jìn)行打包的方法，需要的朋友可以參考下2023-03-03
Spring事務(wù)aftercommit原理及實(shí)踐
這篇文章主要為大家介紹了Spring事務(wù)aftercommit原理及實(shí)踐,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-09-09
運(yùn)用Spring?Aop+注解實(shí)現(xiàn)日志記錄
我們都知道Spring框架的兩大特性分別是 IOC (控制反轉(zhuǎn))和 AOP (面向切面)，這個(gè)是每一個(gè)Spring學(xué)習(xí)視頻里面一開(kāi)始都會(huì)提到的，這里，如果我們使用Aop來(lái)記錄日志，那是再好不過(guò)了，感興趣的朋友跟隨小編一起學(xué)習(xí)下Spring?Aop注解實(shí)現(xiàn)日志記錄的過(guò)程吧2022-01-01
Java 實(shí)戰(zhàn)項(xiàng)目錘煉之樸素風(fēng)格個(gè)人博客系統(tǒng)的實(shí)現(xiàn)流程
讀萬(wàn)卷書不如行萬(wàn)里路，只學(xué)書上的理論是遠(yuǎn)遠(yuǎn)不夠的，只有在實(shí)戰(zhàn)中才能獲得能力的提升，本篇文章手把手帶你用Java+vue+Springboot+ssm+mysql+maven+redis實(shí)現(xiàn)一個(gè)樸素風(fēng)格的個(gè)人博客系統(tǒng),大家可以在過(guò)程中查缺補(bǔ)漏，提升水平2021-11-11
Spring Cloud中關(guān)于Feign的常見(jiàn)問(wèn)題總結(jié)
這篇文章主要給大家介紹了Spring Cloud中關(guān)于Feign的常見(jiàn)問(wèn)題，文中通過(guò)示例代碼介紹的很詳細(xì)，需要的朋友可以參考借鑒，下面來(lái)一起看看吧。2017-02-02
一文詳解SpringBoot如何使用pageHelper做分頁(yè)處理
分頁(yè)是常見(jiàn)大型項(xiàng)目都需要的一個(gè)功能,PageHelper是一個(gè)非常流行的MyBatis分頁(yè)插件,下面就跟隨小編一起來(lái)了解下SpringBoot是如何使用pageHelper做分頁(yè)處理的吧2025-03-03