Swagger for SpringMVC - Springfox 的替代品?

Swagger for SpringMVC - Alternatives to Springfox?

你们中的任何人都可以建议为 Spring 基于 MVC 的 REST API 实施 Swagger 的任何替代方案吗?仅供参考,这不是 Spring 启动。我试过 Springfox,但恕我直言,这是一团乱麻。

您可以尝试使用与 SpringFox 非常相似的 Swagger Maven Plugin, which is a build time annotation processor. If you're using spring-boot with JaxRS you could use Swagger-Core。它知道如何解释 JAX-RS 注释而不是 spring 注释。对于所有这些 基于实现或注释 推断的库,当您有深奥的服务定义或库作者没有考虑过的场景时,您将遇到 bugs/problems .

如果您的目标只是记录 RESTful 个端点,那么优秀的 Spring Rest Docs 可以让您编写由测试驱动的文档。它甚至允许您添加可以扩充生成的文档的手写文档。但是,请记住它不会以机器可读的形式生成服务规范。

也就是说,作为 SpringFox, it would be useful if you could create specific issues to problems you're encountering with SpringFox 的图书馆作者。这将有助于为您和遇到相同问题的任何其他人改进库 bugs/issues。你当然可以抱怨堆栈溢出,但我担心这最多只能让你的问题得票数下降。

https://github.com/RabiAPI/Evalon4J

这是一个命令行工具,用于生成 java restful api 文档,

完全没有烦人的配置!!!

支持的框架

  • SpringMVC
  • JAX-RS
  • Swagger 2.0 注释
  • OpenAPI 3.0 注释
  • JSR303 Bean 验证