Swagger作为一款非常流行的API文档生成工具,相信很多小伙伴都在用。Swagger最为方便的地方在于,你的项目只要集成了它,一启动就能生成最新版文档,而且可以在线调试。不过Swagger的接口调试功能确实有很多缺点,比如对JSON支持不太友好。今天我们使用Knife4j来增强下它,使用的是SpringDoc提供的Swagger实现库,希望对大家有所帮助!
SpringBoot实战电商项目mall(50k+star)地址:github.com/macrozheng/…
聊聊Swagger的Java库
首先我们来聊聊Java中两种比较流行的两种Swagger实现库,对比下哪个更好用。
SpringFox
SpringFox是老牌的Swagger实现库,Github上标星5.6K+
,相信很多小伙伴项目中都集成的是这个库。不过该实现库在两年前发了3.0.0
版本后就再也没发版本了。 而且如果你在SpringBoot 2.6.x版本以上使用的话,会发现许多问题需要自行解决