1、环境
- springboot版本:2.6.1
- swagger版本:2.9.2
2、创建2.6.1版本的springboot项目,目录如下:
3、导入swagger2.9.2版本的依赖
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.9.2</version>
</dependency>
4、在SwaggerConfig里面配置swagger
@EnableSwagger2
@Configuration
public class SwaggerConfig {
@Bean
public Docket docket() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()// 通过.select()方法,去配置扫描接口,RequestHandlerSelectors配置如何扫描接口
.apis(RequestHandlerSelectors.basePackage("com.hewei.controller"))
.build();
}
//配置文档信息
private ApiInfo apiInfo() {
Contact contact = new Contact("梦风心雨","https://blog.csdn.net/weixin_48678547","2381778984@qqqq.com");
return new ApiInfo(
"项目的API", // 标题
"", // 描述
"", // 版本
"", // 组织链接
contact, // 联系人信息
"", // 许可
"", // 许可连接
new ArrayList<>()// 扩展
);
}
}
5、在application.yml里面配置以下代码
spring:
mvc:
pathmatch:
matching-strategy: ant_path_matcher
6、swagger展示的动态api页面
注意:配置第四步的原因是在springboot2.6.1中将SpringMVC 默认路径匹配策略从AntPathMatcher 更改为PathPatternParser,导致出错,解决办法是切换回原先的AntPathMatcher