【问题标题】:How to generate documentation and client code for RAML?如何为 RAML 生成文档和客户端代码?
【发布时间】:2016-12-22 03:10:54
【问题描述】:

我是一个新项目,他们想使用 RAML 来定义 API。我得到了 Eclipse 的 RAML-JAX-RS p0lugin。有了它,我就能够从现有的 REST 服务生成 RAML 文件。我还能够生成 REST 接口类。有一个带有“生成客户端代理代码”选项的复选框。但它不会生成任何客户端代码。仅生成 REST 服务器接口。

我尝试寻找一种方法来生成客户端类和文档文件。 (我假设它可以做到这一点,作为 HTML 文件左右。)我已经看到了一些 maven 插件代码来生成客户端代码,但我看不出它是如何工作的。有谁知道如何生成这些?从 Eclipse、命令行或 Maven 对我来说都可以。最好通过 Maven。

【问题讨论】:

    标签: java eclipse rest raml generated-code


    【解决方案1】:

    我发现到目前为止最好的选择是

    https://github.com/mulesoft-labs/raml-java-client-generator

    我更喜欢兼容 RAML 1.0 的生成器,但似乎没有。

    我们发现 1.0 RAML 需要进行一些更改才能使其正确解析,例如删除示例之前的类型等。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2012-02-15
      • 1970-01-01
      • 2010-11-05
      • 1970-01-01
      相关资源
      最近更新 更多