Swagger2 Api接口管理
pom依赖
<dependercy>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.6.1</version>
</dependercy>
<dependercy>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.6.1</version>
</dependercy>
开启Swagger2配置
@configuration
@EnableSwagger2
@ConditionalOnProperty(name = "swagger.enale", havingValue = "true")
public class ApiSwagger2Config {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.yck.controller")).paths(PathSelectors.any())
.build();
}
// 构建api文档详细信息
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("API")
.termsOfServiceUrl("http://localhost:8081/")
.version("1.0.0")
.description("API DESC")
.build();
}
}
swagger.enale = true / false 可在配置文件中设置,生产环境建议关闭
@ConditionalOnProperty(name = "swagger.enale", havingValue = "true")
系统自带的一些path拦截,需要放行swagger自带的资源
/swagger.*
/webjars/.*
/v2/api.*
controller类上增加@Api注解
@Api(value = "xxxx描述")
接口上增加注解
@ApiOperation(value = "查询xxxx")
访问地址:
自己系统访问 + swagger
http://localhost:8080/swagger-ui.html