WADL生成工具

是否有一个工具将Java文件描述为REST服务作为参数并从中生成一个wadl文件。

我遇到了同样的问题:使用RESTeasy并希望找到一种自动生成WADL的方法。

做了一些研究并得出了以下解决方案。

1.将其添加到您的pom.xml

    com.sun.jersey.contribs maven-wadl-plugin 1.17   generate  generate  ${javadoc-phase}    ${project.build.outputDirectory}/application.wadl  true http://example.com:8080/rest  com.example.rs.resource    com.sun.jersey.server.wadl.generators.WadlGeneratorApplicationDoc    applicationDocsFile ${basedir}/src/main/doc/application-doc.xml     com.sun.jersey.server.wadl.generators.WadlGeneratorGrammarsSupport    grammarsFile ${basedir}/src/main/doc/application-grammars.xml         

注意buildUripackagesResourceConfig元素。 您必须更改它们以反映项目的配置。 您可能还想更改插件的版本(我使用的是1.17)。

2.创建/ doc文件夹并添加一些文件。

创建src/main/doc/文件夹并在下面创建两个文件。

文件: application-doc.xml

内容:

   This is added to the start of the generated application.wadl  

文件: application-grammars.xml

内容:

   

3.运行maven命令。

转到项目文件夹并运行以下命令:

 $ mvn compile com.sun.jersey.contribs:maven-wadl-plugin:generate 

应该生成files \target\classes\application.wadl (WADL本身)和\target\classes\xsd0.xsd (资源的模式 – 它由application.wadl使用)。

根据需要编辑和使用它们。

PS。:请记住,这是maven-wadl-plugin的一个非常简单的用法。 它可以做更多。 要更好地了解它,请参阅其他答案中提到的zip文件(由Pavel Bucek提供)。

是的,请参阅Jersey样本的gerenate-wadl [1]样本(查找maven-wadl-plugin)。

[1] http://search.maven.org/remotecontent?filepath=com/sun/jersey/samples/generate-wadl/1.12/generate-wadl-1.12-project.zip