swagger的使用方法

swagger

简介

早期，前后端做接口文档，是用的 word+git（我看那群在 Bmatch 学的就是用这种方法），但是，一旦项目变大，这种方式就不太方便了

swagger 就是为了解决这个通电。swagger 是一个接口文档生成工具

swagger 使用

集成 swagger

1. 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>

2. 配置类

@Configuration
@EnableSwagger2  //开启 swagger2
public class SwaggerConfig {
   

}

3. 测试运行

输入项目地址+swagger-ui.html

http://localhost:9010/swagger-ui.html

就能弹出 swagger 的接口文档

配置 swagger

1. 配置 swagger 的 docket bean 实例

@Bean
    public Docket docket() {
   
        return