Rest 如何在构建maven项目期间包含从raml文件生成html文件

Rest 如何在构建maven项目期间包含从raml文件生成html文件,rest,maven,building,raml,exec-maven-plugin,Rest,Maven,Building,Raml,Exec Maven Plugin,我正在开发一个JavaREST应用程序,我有记录端点API的raml文件。应用程序是使用maven构建的 到目前为止,我们一直在从raml文件手动生成html文件,但我们希望将从raml文件生成html文件合并到构建过程中(这样每次构建应用程序时都会自动生成html文件,并避免生成代码与html文件不匹配的版本) 目前,我们有一个复杂的问题,一些raml文件是0.8,一些是1.0,但将它们全部转换为1.0并不是一个很大的努力 不可能确切地知道将要进行构建的机器的特性(可能是Linux(Ubunt

我正在开发一个JavaREST应用程序,我有记录端点API的raml文件。应用程序是使用maven构建的

到目前为止,我们一直在从raml文件手动生成html文件,但我们希望将从raml文件生成html文件合并到构建过程中(这样每次构建应用程序时都会自动生成html文件,并避免生成代码与html文件不匹配的版本)

目前,我们有一个复杂的问题,一些raml文件是0.8,一些是1.0,但将它们全部转换为1.0并不是一个很大的努力

不可能确切地知道将要进行构建的机器的特性(可能是Linux(Ubuntu或CentOS)或Windows 10),我们不想假设将要进行构建的机器上已经安装了任何实用程序。例如,我们不想假设raml2html将安装在将要进行构建的机器上

我的问题是:在maven项目的构建过程中,从raml文件生成html文件的最佳/最简单的方法是什么

我认为一种方法是将raml2html作为依赖项包含在maven pom文件中,并在构建过程中调用该工具(可能使用maven插件)。但是我看到的所有与raml2html相关的指南似乎都要求必须在机器上安装raml2html。比如这个:

我不希望将此需求添加到构建过程中。我希望任何人都能够“开箱即用”地编译项目(当然,假设他们安装了maven、java等)

我正在使用的版本:

  • My OS:Ubuntu16.04(构建)该解决方案也应在windows上运行 10) :
  • java版本“1.8.0_121”
  • ApacheMaven 3.3.9
  • npm 3.5.2
  • 节点:v4.2.6

我想这可以让你运行npm安装,如果没有的话。好的,谢谢。基于该插件的文档,它似乎提供了一种安装node和npm的方法,这些node和npm独立于计算机上可能存在的任何现有版本(即,它们是编译的本地版本)。所以我想在尝试安装raml2html时不应该使用“-g”。我曾尝试使用该插件,它确实似乎安装了node、npm和raml2html,但在我尝试运行raml2html的execmaven插件中失败了。它发出的命令执行失败。无法运行程序“raml2html”“。此时似乎无法识别命令raml2html。当raml2html在
路径中不可用时,可能会发生这种情况。”。但是在maven插件中运行之后,您是否尝试过不同的配置选项,如
目标
。嗨,现在可以了。正如你所想,我的问题是路径问题。谢谢!你能分享你的最终解决方案吗?