如何为RAML生成文档和客户端代码?

时间:2016-08-15 21:09:03

标签: java eclipse rest raml generated-code

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

我尝试了一种生成客户端类和文档文件的方法。 (我假设它可以做到这一点,就像HTML文件一样。)我看过一些maven插件代码来生成客户端代码,但我看不出它是如何工作的。有谁知道如何生成这些?无论是从Eclipse,命令行还是Maven都可以。最好通过Maven。

1 个答案:

答案 0 :(得分:0)

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

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

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

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