可以将spring-auto-restdocs与Swagger/SpringFox一起使用吗？

Question

可以将spring-auto-restdocs与Swagger/SpringFox，swagger2markup一起使用吗？

我想：-使用Swagger/SpringFox提供测试区域，但我希望该UI中的示例类似于- spring-restdoc提供示例代码片段，并-使用spring-auto-restdocs从POJO获取表示JSON对象的文档，只需将Javadoc添加到字段，而不是swagger注释

Answer 1

我看不到简单的方法来实现这一点。如果不使用任何Swagger代码(无论是注释还是SpringFox DSL)，SpringFox或swagger2markup都不是很有用。如果您同时拥有Swagger注解和Spring (Auto) REST Docs，那么可以将Spring (Auto) REST Docs生成的AsciiDoc片段包含到用于swagger2markup的AsciiDoc中。AsciiDoc支持包含其他AsciiDoc文件，当将Spring REST Docs片段包含到手写文档中时，也会使用此功能。

我研究了如何从REST Docs片段生成Swagger/OpenAPI文件，并编写了一个指南来指导如何做到这一点。然而，https://github.com/fbenz/restdocs-to-swagger是一种工具组合，而不是简单的集成。此外，字段和方法文档不会包含在Swagger文件/UI中。