最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

SpringBoot任意版本集成Swagger各種版本的操作指南

 更新時間:2024年07月11日 11:09:58   作者:??????鯨落  
在學(xué)習(xí)Swagger生成API文檔的時候經(jīng)常會遇到問題,而目前市面上大部分技術(shù)分享者的SpringBoot版本并沒和我們的同步,導(dǎo)致一些一模一樣的代碼,在我們的項目上卻無法使用,這是一個經(jīng)常性的問題,本文章就旨在和大家搞定SpringBoot任意版本集成Swagger各種版本

引言:喜歡自學(xué)的新手們,在學(xué)習(xí)Swagger生成API文檔的時候經(jīng)常會遇到問題,而目前市面上大部分技術(shù)分享者的SpringBoot版本并沒和我們的同步,導(dǎo)致一些一模一樣的代碼,在我們的項目上卻無法使用,這是一個經(jīng)常性的問題,本文章就旨在和大家列舉幾種常用的項目搭配,來解決訪問網(wǎng)址:http://localhost:8080/swagger-ui/index.html 報錯“Error Page”的問題。

首先聲明一下使用 Spring Boot 2.7 及以上版本時,Swagger 2.9.2會有一些兼容性問題,很有可能在項目運行前我們就飲恨于此了。

比較常見的幾個錯誤:

1、“org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException”

2、“Failed to start bean 'documentationPluginsBootstrapper'

3、“Caused by: java.lang.NullPointerException: null”。

簡單的解決辦法: 

版本對應(yīng)(Maven官方倉庫:https://mvnrepository.com/

①SPB(SpringBoot) 2.7 以下 + Swagger-ui 和Swagger2 2.9.2

②SPB(SpringBoot) 2.7 往上 + springfox-boot-starter(3.0.0包括Swagger-ui 和Swagger2 3.0.0)

直接改用Springdoc OpenAPI

補充性說明

一、低版本過程性搭建

1、依賴展示

<properties>
 
//……省略
    <spring-boot.version>2.5.3</spring-boot.version>
</properties>
  //……省略
 
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-dependencies</artifactId>
    <version>${spring-boot.version}</version>  
    <type>pom</type>
    <scope>import</scope>
</dependency>
 
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
 
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

2、配置Swagger

(1)最小環(huán)境搭建

*注意低版本url:http://localhost:8080/swagger-ui.html

*注意高版本url:http://localhost:8080/swagger-ui/index.html

???????import org.springframework.context.annotation.Configuration;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
 
@EnableSwagger2
@Configuration  // 注入spring boot
public class SwaggerConfig {
 
} // 只用這幾行代碼就可以運行

二、高版本過程性搭建

1、依賴展示

//……省略
<spring-boot.version>2.7.6</spring-boot.version>
// ……省略
<dependency>  
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

2、配置Swagger

(1)最小環(huán)境搭建

重要:修改配置文件!修改配置文件!修改配置文件!重要的事說三遍!?。?/p>

# application.properties寫法
 
# Spring Boot 2.6.X版本引入了新的路徑匹配策略,這導(dǎo)致了與Springfox的不兼容。
# Spring Boot使用PathPatternMatcher作為默認的路徑匹配策略,而Springfox依賴于
# AntPathMatcher。所以做以下修改:
spring.mvc.pathmatch.matching-strategy=ANT_PATH_MATCHER

*注意低版本url:http://localhost:8080/swagger-ui.html

*注意高版本url:http://localhost:8080/swagger-ui/index.html

import org.springframework.context.annotation.Configuration;
import springfox.documentation.oas.annotations.EnableOpenApi;
 
@EnableOpenApi	// config文件只改變了這里哦
@Configuration  // 注入spring boot
public class SwaggerConfig {
 
}

三、Springdoc OpenAPI高低環(huán)境搭建

得多皮才非得高配低、低配高???我可沒這閑工夫再寫了,上面兩種解決方法自己排列組合試去吧

四、配置Swagger

以上所有SwaggerConfig配置類都是默認情況,下面簡單分享一下自定義配置項。

@EnableOpenApi
@Configuration  // 注入spring boot
public class SwaggerConfig {
    @Bean   // 要想配置生效必須注入
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com"))
                .paths(PathSelectors.any())
                .build();
    }
    private ApiInfo apiInfo()
    {
        return new ApiInfoBuilder()
                .title("Spring Boot2.7.6中使用Swagger3.0.0構(gòu)建RESTful APIs")
                .description("我可是描述信息哈~~更多Spring Boot相關(guān)文章請關(guān)注:http://blog.didispace.com/")
                .version("8.0")
                .build();
    }
}

以上就是SpringBoot任意版本集成Swagger各種版本的操作指南的詳細內(nèi)容,更多關(guān)于SpringBoot集成Swagger的資料請關(guān)注腳本之家其它相關(guān)文章!

相關(guān)文章

  • jdk中密鑰和證書管理工具keytool常用命令詳解

    jdk中密鑰和證書管理工具keytool常用命令詳解

    keytool JAVA是個密鑰和證書管理工具。它使用戶能夠管理自己的公鑰/私鑰對及相關(guān)證書,用于(通過數(shù)字簽名)自我認證(用戶向別的用戶/服務(wù)認證自己)或數(shù)據(jù)完整性以及認證服務(wù)
    2014-01-01
  • Elasticsearch?percolate?查詢示例詳解

    Elasticsearch?percolate?查詢示例詳解

    這篇文章主要為大家介紹了Elasticsearch?percolate?查詢示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪
    2023-01-01
  • 基于java中反射的總結(jié)分析

    基于java中反射的總結(jié)分析

    所謂反射,就是根據(jù)一個已經(jīng)實例化了的對象來還原類的完整信息
    至少對我而言,我認為它帶給我的好處是,讓我從下往上的又了解了一遍面向?qū)ο?/P>

    2013-05-05
  • Spring中@RestController和@Controller的使用及區(qū)別

    Spring中@RestController和@Controller的使用及區(qū)別

    這篇文章主要介紹了Spring中@RestController和@Controller的使用及區(qū)別,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
    2025-03-03
  • Spring?Boot中優(yōu)雅地處理參數(shù)傳遞的技巧分享

    Spring?Boot中優(yōu)雅地處理參數(shù)傳遞的技巧分享

    最近一直在學(xué)習(xí)Spring Boot,今天將其中的從前臺過來的參數(shù)傳遞總結(jié)一下,下面這篇文章主要給大家介紹了關(guān)于Spring?Boot中優(yōu)雅地處理參數(shù)傳遞的技巧,文中通過實例代碼介紹的非常詳細,需要的朋友可以參考下
    2023-05-05
  • 通過Java實現(xiàn)獲取表的自增主鍵值

    通過Java實現(xiàn)獲取表的自增主鍵值

    這篇文章主要為大家詳細介紹了如何通過Java實現(xiàn)獲取表的自增主鍵值,文中的示例代碼講解詳細,具有一定的學(xué)習(xí)價值,感興趣的可以了解一下
    2023-06-06
  • @Transaction,@Async在同一個類中注解失效的原因分析及解決

    @Transaction,@Async在同一個類中注解失效的原因分析及解決

    這篇文章主要介紹了@Transaction,@Async在同一個類中注解失效的原因分析及解決方案,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教
    2021-12-12
  • SpringBoot微服務(wù)注冊分布式Consul的詳細過程

    SpringBoot微服務(wù)注冊分布式Consul的詳細過程

    這篇文章主要介紹了SpringBoot(微服務(wù))注冊分布式Consul,Spring Boot應(yīng)用可以通過向Consul注冊自身來實現(xiàn)服務(wù)發(fā)現(xiàn)和治理,使得其他服務(wù)可以在Consul中發(fā)現(xiàn)并調(diào)用它,需要的朋友可以參考下
    2023-04-04
  • SpringCloud?Feign請求頭刪除修改的操作代碼

    SpringCloud?Feign請求頭刪除修改的操作代碼

    這篇文章主要介紹了SpringCloud?Feign請求頭刪除修改,本文通過實例代碼給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下
    2022-03-03
  • Springboot配置AOP的注解切點失效解決方案

    Springboot配置AOP的注解切點失效解決方案

    本文探討了在Spring框架中使用AOP攔截靜態(tài)方法調(diào)用的實現(xiàn)細節(jié),重點在于ApplicationContext和ApplicationContextAware接口的使用差異,通過對比兩種獲取Bean的方式,最終解決了切點無法被攔截的問題
    2026-06-06

最新評論

平果县| 玛多县| 安康市| 谢通门县| 金塔县| 长汀县| 桓仁| 鸡泽县| 牡丹江市| 个旧市| 彭泽县| 许昌市| 东安县| 建湖县| 绥江县| 晋州市| 塘沽区| 镇巴县| 赤水市| 枝江市| 东丰县| 卓尼县| 弥渡县| 阳春市| 嘉善县| 兴海县| 古蔺县| 九龙县| 搜索| 无为县| 恩平市| 苏尼特右旗| 长葛市| 织金县| 怀宁县| 溆浦县| 吴旗县| 海盐县| 汝阳县| 梓潼县| 宜宾市|