Swagger With Spring-Data-Rest

Question

有没有人给swagger配置了spring-data-rest。我知道swagger有一个扫描所有spring-mvc请求映射的DocumentationConfig类。但是，如何将其用于spring-data-rest，因为没有定义显式的请求映射。在这方面的任何帮助都非常感谢。另外，我想知道是否有其他支持Spring-Data-Rest的文档框架。

Answer 1

在高于2.6.0的SpringFox版本中，添加了对spring data rest的支持(但它仍处于孵化阶段)。为了添加对Spring Data Rest的支持，您需要包含以下依赖项：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-data-rest</artifactId>
    <version>2.6.1</version>
</dependency>

Answer 2

这已经存在了一段时间了，但是正如其他人所提到的，(仍然)没有支持Spring Data Rest的Swagger实现。然而，Spring Data Rest确实遵循HAL规范，并且HAL Browser与任何SDR项目都是无缝集成的。再加上新版本的ALPS公开SDR元数据，这应该足以满足您的文档目标。

Answer 3

第二个问题的答案:结合使用SDR和Spring REST Docs/RestAssured可以很好地记录AsciiDoctor端点。不过，它确实需要一些手动工作，因为唯一的自动化部分将是创建代码片段。然后可以将这些文件加载到AsciiDoc文件中。