1、springBoot整合swagger
pom.xml文件加入依赖
io.springfox
springfox-swagger2
2.9.2
io.springfox
springfox-swagger-ui
2.9.2
application.yml文件加入配置
swagger:
basePackage: com.qianfeng.springboot.swagger
title: 图书管理平台API(设置标题)
description: 书店平台的REST API,所有应用程序都可以通过JSON访问对象模型数据。
contact: qianfeng
version: v1.0
url: http://www.1000phone.com
加入配置类,加上注解@Configuration、@EnableSwagger2
1、@value取yml以${}方式取配置文件中的属性,
2、实体类可以加入@ApiModel(value ="用户对象",description ="对应用户表")的注释,
3、controller的方法加入@ApiOperation(value ="查询所有用户")的注解可以配置描述信息
@Configuration
@EnableSwagger2
public class SwaggerConfig implements WebMvcConfigurer {
@Value("${swagger.basePackage}")
private String basePackage;
@Value("${swagger.title}")
private String title;
@Value("${swagger.version}")
private String version;
@Value("${swagger.description}")
private String description;
@Value("${swagger.concat}")
private String concat;
@Value("${swagger.url}")
private String url;
@Bean
public Docket createApi(){
return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select().apis(RequestHandlerSelectors.basePackage(basePackage)).paths(PathSelectors.any()).build();
}
private ApiInfo apiInfo(){
return new ApiInfoBuilder().title(title).contact(concat).description(description).version(version).licenseUrl(url).build();
}
@Override
public void addViewControllers(ViewControllerRegistry registry) {
registry.addRedirectViewController("/api","/swagger-ui.html");
}