使用 Spring-Data-Rest 招摇

Question

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

Answer 1

第二个问题的答案： AsciiDoctor 结合Spring REST Docs/RestAssured 可以成为记录 SDR 端点的简洁方式。不过，它确实需要一些手动操作，因为唯一的自动化部分将是创建 sn-ps。然后可以将它们加载到您的 AsciiDoc 文件中。

Answer 2

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

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

Answer 3

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