对于我们App开发人员来说,API那就是生命中的血液,每日都在在我们的App中穿插流淌,但是对于API的数据测试和预览管理那是十分头疼的一件事情,那么问题来了?今天就来个干货帮咱们完成这个东东……下次服务端的童靴再不好好写API的时候就把这个砸他脸就成……
导入依赖
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.2.2</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.2.2</version>
</dependency>
Application同级目录下创建Swagger服务 结构如下:
文件内部代码如下
@Configuration
@EnableSwagger2
public class Swagger2 {
@Bean
public Docket createRestfullApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.xsk"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("Swagger2 ")
.description("使用Swagger2做API预览")
.termsOfServiceUrl("http://www.baidu.com")
.contact("lylapp@163.com")
.version("0.0.1")
.build();
}
}
如上代码所示,通过@Configuration注解,让Spring来加载该类配置。再通过@EnableSwagger2注解来启用Swagger2。
帮助文档查看 swagger