Swagger2 和 Swagger3 的不同
Swagger2 和 Swagger3 的不同
SpringBoot 整合 Swagger3 和 Swagger2 的主要区别如下：
区别一：引入不同的依赖
- 如果使用的是 Swagger 3
<dependency><groupId>io.springfox</groupId><artifactId>springfox-boot-starter</artifactId><version>3.0.0</version>
</dependency>
- 如果使用的是 Swagger 2
<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger2</artifactId><version>2.9.2</version>
</dependency><dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger-ui</artifactId><version>2.9.2</version>
</dependency>
区别二：使用不同的注解
- 如果使用的是 Swagger 3
@Configuration
@EnableOpenApi // 可省略
public class SwaggerConfig {...
}
- 如果使用的是 Swagger 2
@Configuration
@EnableSwagger2
public class SwaggerConfig {...
}
区别三：使用不同的枚举变量
- 如果使用的是 Swagger 3
new Docket(DocumentationType.OAS_30)
- 如果使用的是 Swagger 2
new Docket(DocumentationType.SWAGGER_2)
区别四：访问不同的 swagger ui 页面路径
-
如果使用的是 Swagger 3：http://localhost:8080/swagger-ui/index.html
-
如果使用的是 Swagger 2：http://localhost:8080/swagger-ui.html
区别五：暴露的 json 接口不同
-
如果使用的是 Swagger 3：http://localhost:8080/v3/api-docs
-
如果使用的是 Swagger 2：http://localhost:8080/v2/api-docs