Swagger3.0，你所不知道的新变化！

Springfox 3.0 版本更新摘要

松哥推出了原创的Spring Boot视频教程，同时分享了Springfox 3.0的最新变化。此版本支持OpenAPI（原Swagger规范），为REST API提供标准化描述。

OpenAPI 支持

OpenAPI是一种描述REST API的标准格式，内容包括接口操作、参数、响应、认证方法及联系信息等。更多详情可在GitHub查阅。

依赖简化

相较于2.9.2版本需添加两个依赖，3.0版本仅需要一个starter依赖（springfox-boot-starter），简化了配置。

接口地址变更

3.0版的接口地址从2.9.2版的"/v2/api-docs"和"/swagger-ui.html"变为"/v3/api-docs"和"/swagger-ui/index.html"。尝试访问旧地址将返回404错误。

注解更新

虽然旧注解可用，但3.0版引入了新注解如@EnableOpenApi，它导入OpenApiDocumentationConfiguration配置类。不过，在许多情况下，这个注解似乎并不是必需的。另外，一些旧注解已经移动到了不同的包，需要注意导包问题。例如，@ApiOperation现可用@Operation替代。

结语

文章总结了Swagger 3.0的重要更新，包括对OpenAPI的支持、依赖简化、接口地址变更和注解更新。松哥还提供了Spring Boot入门教程，讲解Swagger的使用方法。

2021年DevOps的四大趋势

了解更多

想要了解更多内容？

查看原文：Swagger3.0，你所不知道的新变化！

文章来源：

江南一点雨

扫码关注公众号