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
注意buildUri
和packagesResourceConfig
元素。 您必须更改它们以反映项目的配置。 您可能还想更改插件的版本(我使用的是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)。