之前在SpringBoot项目中一直使用的是SpringFox提供的Swagger库,上了下官网发现已经有接近两年没出新版本了!前几天升级了SpringBoot 2.6.x 版本,发现这个库的兼容性也越来越不好了,有的常用注解属性被废弃了居然都没提供替代!无意中发现了另一款Swagger库
SpringDoc
,试用了一下非常不错,推荐给大家!
SpringBoot实战电商项目mall(50k+star)地址:github.com/macrozheng/…
SpringDoc是一款可以结合SpringBoot使用的API文档生成工具,基于OpenAPI 3
,目前在Github上已有1.7K+Star
,更新发版还是挺勤快的,是一款更好用的Swagger库!值得一提的是SpringDoc不仅支持Spring WebMvc项目,还可以支持Spring WebFlux项目,甚至Spring Rest和Spring Native项目,总之非常强大,下面是一张SpringDoc的架构图。
接下来我们介绍下SpringDoc的使用,使用的是之前集成SpringFox的
mall-tiny-swagger
项目,我将把它改造成使用SpringDoc。
首先我们得集成SpringDoc,在
pom.xml
中添加它的依赖即可,开箱即用,无需任何配置。
<!--springdoc 官方Starter-->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-ui</artifactId>
<version>1.6.6</version>
</dependency>
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。