自动 JAX-RX 到 RAML答案

【问题标题】：Automatic JAX-RX to RAML自动 JAX-RX 到 RAML
【发布时间】：2016-01-11 02:29:30
【问题描述】：

我已经使用 resteasy 编写了我的 Java 项目的 Web 服务。对于文档过程，我希望使用 RAML 捕获这些 Web 服务。

为此，我能够找到一个 RAML 的 eclipse 插件，它将生成一个 .raml 文件。但是我们必须手动完成，即点击类文件或包来生成raml文件。

所以我的问题是 - 是否有一种方法可以在项目打包期间生成用于 Web 服务或包下的所有类、raml 文件。

说在构建过程中使用 maven。

请推荐

【问题讨论】：

标签： java web-services maven resteasy raml

【解决方案1】：

是的，有：https://github.com/mulesoft/raml-for-jax-rs

RAML for JAX-RS 同时拥有RAML → JAX-RS 和JAX-RS → RAML Maven 插件，后者正是您要找的。p>

【讨论】：

使用您指定的文档和github.com/mulesoft/raml-for-jax-rs/blob/master/maven-plugin.md 按照指定的所有步骤，我在打包项目时收到此错误 [错误] 插件 org.raml.plugins:jaxrs-raml-maven-plugin :1.3.4-SNAPSHOT 或其依赖项之一无法解析：无法读取 org.raml.plugins:jaxrs-raml-maven-plugin:jar:1.3.4-SNAPSHOT 的工件描述符：找不到工件 org。 Nexus-One 中的 raml:jaxrs-to-raml:pom:1.3.4-SNAPSHOT (mvn-repo/nexus/content/groups/One) -> [Help 1] 你能建议一下吗？
使用 1.3.3 解决了上述问题，但给了我另一个错误 [ERROR] Failed to execute goal org.raml.plugins:jaxrs-raml-maven-plugin:1.3.3:generate-raml (默认）在项目spectralight上：目标org.raml.plugins的执行默认值：jaxrs-raml-maven-plugin：1.3.3：generate-raml失败：执行org.raml.plugins时遇到API不兼容：jaxrs-raml- maven-plugin:1.3.3:generate-raml: java.lang.NoSuchMethodError: com.mulesoft.jaxrs.raml.annotation.model.IParameterModel.getType()Ljava/lang/String;请你也可以为此提出建议。
我开始查看com.mulesoft.jaxrs.raml.annotation包的类文件，才知道IParameterModel接口中不存在getType()方法。相反，有一个方法 getParameterType()。所以我得到的上述错误似乎是正确的。现在的问题是缺少该方法在 1.3.3 中使用的哪个版本。如果我错了，请纠正我。或者有没有其他方法可以解决这个问题。
不知道发生了什么，这曾经工作正常。请在此处为项目维护者打开一个问题：github.com/mulesoft/raml-for-jax-rs/issues
非常感谢大卫。我已经在 github 上提交了一个问题。以防万一你想在这里关注它是链接 - github.com/mulesoft/raml-for-jax-rs/issues/140