swagger
简介
早期,前后端做接口文档,是用的 word+git(我看那群在 Bmatch 学的就是用这种方法),但是,一旦项目变大,这种方式就不太方便了
swagger 就是为了解决这个通电。swagger 是一个接口文档生成工具
swagger 使用
集成 swagger
- maven 依赖
<!-- 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>
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
- 配置类
@Configuration
@EnableSwagger2 //开启 swagger2
public class SwaggerConfig {
}
- 测试运行
输入项目地址+swagger-ui.html
http://localhost:9010/swagger-ui.html
就能弹出 swagger 的接口文档
配置 swagger
- 配置 swagger 的 docket bean 实例
@Bean
public Docket docket() {
return