第九节:SpringBoot在线文档Swagger2入门

发布网友发布时间：2024-10-07 21:58

共1个回答

热心网友时间：2024-11-11 17:30

Swagger2 是一个用于生成 RESTful Web 服务文档的开源项目。它提供了一个用户界面，可通过 Web 浏览器访问和测试 RESTful Web 服务接口。

在配置 SpringBoot 与 Swagger2 的集成时，对于 3.0 版本以下，需要在 pom.xml 文件中引入相应的依赖并配置 Swagger2Config 文件，使用 @EnableSwagger2 注解来开启 Swagger2。浏览器访问路径为：http://127.0.0.1:8080/swagger-ui.html。

对于 Swagger2 3.0版本及以上，配置文件和 pom.xml 的改动不大，但无需使用 @EnableSwagger2 注解。在启动类中添加 @EnableOpenApi 注解即可，浏览器访问路径为：http://127.0.0.1:8080/swagger-ui/。

Swagger2 中常用的注解有 @Api、@ApiOperation、@ApiImplicitParams、@ApiImplicitParam、@ApiResponses、@ApiModel 和 @ApiModelProperty 等。其中，@Api 注用于描述类的功能说明，@ApiOperation 和 @ApiImplicitParams 用于说明入参数，@ApiResponses 用于描述请求返回的状态码及描述，@ApiModel 和 @ApiModelProperty 分别用于描述实体类和实体类的属性。

在演示案例中，如 RumenzController，通过在线测试接口，用户可以点击 Try it out 按钮，填写相关参数进行测试。完整的源码地址为：[源码链接]。本小结主要介绍了 Swagger2 的基本使用、配置方式以及常见注解的用途，旨在帮助开发者快速上手并应用到实际项目中。