【问题标题】:Swagger With Spring-Data-Rest使用 Spring-Data-Rest 招摇
【发布时间】:2014-04-15 22:17:09
【问题描述】:

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

【问题讨论】:

  • 正如您已经提到的,Spring MVC 不支持 Spring Data Rest。最近有人为此在Github 上开了一个问题。希望我们能尽快获得对 Spring Data Rest 的支持。
  • 是我在 Github 上打开了这个问题 :-) 他们要求为 Spring-Data-Rest 编写实现
  • 好的。很高兴知道:-)

标签: swagger spring-data-rest


【解决方案1】:

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

【讨论】:

    【解决方案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>
    

    【讨论】:

    【解决方案3】:

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

    【讨论】:

    • 但是 Spring MVC 控制器不支持 ALPS。这提供了不一致。有没有一种解决方案可以同时适用于两者?
    猜你喜欢
    • 2017-10-06
    • 2018-09-11
    • 2020-02-02
    • 2015-12-03
    • 1970-01-01
    • 2019-04-06
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多