swagger在高版本springboot中的使用
阿新 • • 發佈:2022-05-12
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