新版本 VS 老版本
新版本和老版本的区别主要体现在以下 4 个方面:
- 依赖项的添加不同:新版本只需要添加一项,而老版本需要添加两项;
- 启动 Swagger 的注解不同:新版本使用的是
@EnableOpenApi
,而老版本是@EnableSwagger2
;
- Docket(文档摘要信息)的文件类型配置不同:新版本配置的是
OAS_3
,而老版本是SWAGGER_2
;
- Swagger UI 访问地址不同:新版本访问地址是“http://localhost:8080/swagger-ui/”,而老版本访问地址是“http://localhost:8080/swagger-ui.html”。
总结
Swagger 新版本让人印象深刻的优点有两个:第一,配置变得简单了,比如依赖项配置减少了 50%,第二,新版 Swagger 页面设计风格有了不小的改变,新版的页面让人感觉更加现代化也更加具有科技感了,总体来说美观了不少。
值得一提的是 Swagger 的整个升级过程很平滑,从老版本升级到新版本,只需要简单的配置即可,那些用于描述接口的注解还是延续了老版本的用法,这样就可以在不修改大部分主要代码的情况下,可以成功到最新版本啦。