Swagger for SpringMVC - Springfox的替代品?

时间:2017-05-04 13:39:28

标签: spring-mvc swagger springfox

你们有没有建议任何替代方法来实现基于Spring MVC的Swagger REST API?仅供参考,这不是春季启动。我已经尝试过Springfox,但恕我直言,这是一个多乱的混乱。

2 个答案:

答案 0 :(得分:4)

您可以尝试使用Swagger Maven Plugin,这是一个构建时注释处理器。如果您使用带有JaxRS的spring-boot,则可以使用Swagger-Core,这与SpringFox非常相似。它知道如何解释JAX-RS注释而不是Spring注释。对于基于实现或注释推断的所有这些库,当您拥有深奥的服务定义或库作者未考虑的场景时,您将遇到错误/问题。

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

尽管如此,作为SpringFox的图书馆作者,如果您能create specific issues遇到SpringFox遇到的问题,那将会非常有用。这将有助于您和其他遇到相同错误/问题的人改进库。你当然可以咆哮堆栈溢出,但我担心这可能只会让你的问题最多只能得到投票。

答案 1 :(得分:1)

https://github.com/RabiAPI/Evalon4J

这是用于生成Java Restful API文档的命令行工具,

根本没有烦人的配置!!!

受支持的框架

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