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","ll@163.com")); 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

浙公网安备 33010602011771号