自学内容网 自学内容网

Spring Boot 进阶-实战Spring Boot整合Swagger3.0

在这里插入图片描述
  说到Swagger有人会问Swagger到底是什么?作为一个后端开发人员来讲,为什么要使用Swagger呢?因为我们现在完成的项目大多数情况下都是前后端分离的项目,而对于前端开发人员来讲,他们需要调用接口,才能获取到对应的数据。那么这个接口如何获取,总不能是后端开发人员弄好之后一个接口一个接口复制删帖给人家吧?当然这种操作在接口少量的情况下很容易就实现了,但是如果接口数量较多的情况下就有点太不可取了。

  这个时候Swagger就应用而生了,Swagger将项目中的接口进行统一的管理,前端开发人员只需要将这套接口文档获取到就可以查找到自己想要的接口了。使用Swagger的好处也就显而易见了。

使用Swagger 的好处

  • 无依赖:UI适配与任何的开发环境,无论是本地还是Web
  • 人性化:允许开发人员轻松交互并且尝试API的每个操作,方便使用
  • 易导航:使用文档分类整理可以快速地查找到自己想要的资源
  • 支持所有浏览器:SwaggerUI支持了几乎所有的主流浏览器
  • 定制化:可以通过源代码的方式访问到需要调整的SwaggerUI
  • 支持OAS技术

Swagger3.0

  Swagger3.0 是在Swagger2.0的基础上坐了一次大的升级,在官方文档上给出了如下的一些修改

  • 删除了对于springfox-swagger2的依赖
  • 删除了所有@EnableSwagger2XXX的注解
  • 添加了关于Swagger的使用场景启动器springfox-boot-starter依赖
  • 移除了guava等第三方依赖相关
  • 修改文档访问地址为http://ip:port/project/swagger-ui/index.html

  既然做了这么多的修改,那么接下来我们就来带着大家来一起实战Spring Boot整合Swagger3.0吧。

整合Swagger3.0

  第一步、在POM文件中引入对应的场景启动器

<dependency>
     <groupId>io.springfox</groupId>
     <artifactId>springfox-boot-starter</artifactId>
     <version>3.0.0</version>
</dependency>

  第二步、编写Swagger的基础配


原文地址:https://blog.csdn.net/nihui123/article/details/142773887

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!