JAX-RS 到 RAML 示例不起作用

Question

这里是场景。我是RAML 的新手。我们已经使用jax-rs 编写了 REST 服务。现在我们要集成RAML 来生成这些API 的文档。

我已经在 RAML for JAX-RS 的帮助下将 RAML JAX-RS 插件安装到 eclipse 中

并且还从RAML fo JAX-RS on GITHUB下载了存储库

给出了jax-rs到RAMLhere的示例

我已经阅读了文档，但仍在努力开始实际实施。

我想知道如何从 Eclipse 运行这些示例以及如何使用 jax-rs 从已编写的 REST API 生成 RAML ？

更新：

我已将示例导入为现有的maven 项目。并尝试从示例文件夹中的HelloWorldRest.java 生成RAML。并低于错误。请找到附件截图。

java.lang.IllegalStateException: Java Model Exception: Java Model Status [RAML_POC does not exist]

更多更新

我执行了以下导入步骤： 在 Package Explorer -> Maven -> Existing Maven Projects -> Selected root directory of repository -> 选择的可用 3 个项目中导入：com.mulesoft.jaxrs.raml.generator、com.mulesoft.jaxrs.raml.generator.annotations 和 jaxrs- raml-maven-插件。

然后打开HelloWorldRest.java，右键单击并选择Generate RAML from classes。并得到提到的错误。

git 存储库结构也可以在附加的屏幕截图中找到。

Answer 1

似乎该错误是由于您实际上没有将项目设置为"Java Project" 造成的。因此，您选择的源代码（在本例中为 HelloWorldRest.java）尚未被解析为 "Source Code"。

你可以试试：

• 将示例项目（helloworld 项目）直接导入为 maven 项目，而不是 jaxrs-raml-maven-plugin 项目。或者，

• 将文件夹src/main/java/helloworld/ 设置为源文件夹。这可以通过：

  1. 首先将项目转换为分面形式。
  2. 确保将examples/helloworld/src/main/java 设置为源文件夹

尝试上述任一步骤后。尝试从类中再次生成 RAML。