1. 程式人生 > 其它 >swagger在高版本springboot中的使用

swagger在高版本springboot中的使用

1.swagger的版本很多,但是自從springboot升級到2.6.0以上後,swagger的版本似乎沒有很好的去匹配

2.不多說,直接上程式碼

第一步:pom檔案中配置swagger的外掛

    <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>3.0.0</version>
        </
dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>3.0.0</version> </dependency> <dependency> <groupId>io.springfox</
groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency>

目前引用的swagger,我找的是比較新的,3.0.0的版本,稍微老一點的版本也是可以的

第二步:配置swagger的配置檔案

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    //swagger會幫助我們生成介面文件
/* * 1,配置文件資訊 * 2,配置生成資訊 * 3,Docket封裝介面文件資訊 * * */ @Bean public Docket getDocket(){ Docket docket = new Docket(DocumentationType.SWAGGER_2); ApiInfoBuilder apiInfoBuilder = new ApiInfoBuilder(); apiInfoBuilder.title("檔案庫房專案後端介面說明") .description("此文件詳細說明了檔案庫房專案的後端介面規範...") .version("1.0"); // .contact(new Contact("F_M","www.demo.org","[email protected]")); ApiInfo apiInfo = apiInfoBuilder.build(); docket.apiInfo(apiInfo).select() .apis(RequestHandlerSelectors.basePackage("com.smx")) .paths(PathSelectors.any())//.regex("/user/") .build(); return docket; } }

這裡注意:頭部的兩個註釋

第三步:其實到這裡,swagger就配置完成了,但是新版本的springboot還是無法正常編譯,出現一堆的錯誤。

注意:在啟動類檔案中,增加一個註釋來解決這個問題:@EnableWebMvc

第四步:這時候開啟swagger文件就可以正常的訪問了。注意的是,新版本的swagger地址調整成:swagger-ui/index.html