Swagger
简介
- 号称世界上最流行的API框架；
- Restful API 文档在线生成工具 —> API文档与API定义同步更新
- 直接运行，可以在线测试 API 接口；
- 支持各种语言；（Java，PHP…）
官网
Spring Boot 集成 Swagger
在项目中使用 Swagger 需要Springfox
- swagger 2
- swagger ui
1、新建一个Spring Boot = web 项目；
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>
3、HelloWorld
4、配置 Swagger ==> Congfig
@Configuration
@EnableSwagger2 // 开启 Swagger 2
public class SwaggerConfig {
}
5、访问页面：http://localhost:8080/swagger-ui.html
配置 Swagger
Swagger 的 bean实例 Docket;
@Configuration
@EnableSwagger2 // 开启 Swagger 2
public class SwaggerConfig {// 配置了 Swagger 的 Docket 的bean实例@Beanpublic Docket docket(){return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo());}// 配置 Swagger 信息public ApiInfo apiInfo(){// 作者信息Contact contact = new Contact("小贱", "http://sword-man.cn/index.html", "xiaojian2436@163.com");return new ApiInfo("小贱的Swagger API文档","但行好事，莫问前程","1.0","http://sword-man.cn/index.html",contact,"Apache 2.0","http://www.apache.org/licenses/LICENSE-2.0",new ArrayList());}
}
