WADL生成工具

WADL生成工具

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

做了一些研究，得出下面的解决方案。

1.将此添加到您的

pom.xml

：

<build><plugins>    <plugin>        <groupId>com.sun.jersey.contribs</groupId>        <artifactId>maven-wadl-plugin</artifactId>        <version>1.17</version>        <executions> <execution>     <id>generate</id>     <goals>         <goal>generate</goal>     </goals>     <phase>${javadoc-phase}</phase> </execution>        </executions>        <configuration> <wadlFile>${project.build.outputDirectory}/application.wadl </wadlFile> <formatWadlFile>true</formatWadlFile> <baseUri>http://example.com:8080/rest</baseUri> <packagesResourceConfig>     <param>com.example.rs.resource</param> </packagesResourceConfig> <wadlGenerators>     <wadlGeneratorDescription>         <className>com.sun.jersey.server.wadl.generators.WadlGeneratorApplicationDoc         </className>         <properties>  <property>      <name>applicationDocsFile</name>      <value>${basedir}/src/main/doc/application-doc.xml</value>  </property>         </properties>     </wadlGeneratorDescription>     <wadlGeneratorDescription>         <className>com.sun.jersey.server.wadl.generators.WadlGeneratorGrammarsSupport         </className>         <properties>  <property>      <name>grammarsFile</name>      <value>${basedir}/src/main/doc/application-grammars.xml</value>  </property>         </properties>     </wadlGeneratorDescription> </wadlGenerators>        </configuration>    </plugin></plugins></build>

注意

buildUri

和

packagesResourceConfig

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

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

创建

src/main/doc/

文件夹并在下面创建两个文件。

文件： application-doc.xml

内容：

<?xml version="1.0" encoding="UTF-8"?><applicationDocs targetNamespace="http://wadl.dev.java.net/2009/02">    <doc xml:lang="en" title="A message in the WADL">This is added to the start of the generated application.wadl</doc></applicationDocs>

文件： application-grammars.xml

内容：

<?xml version="1.0" encoding="UTF-8" ?><grammars xmlns="http://wadl.dev.java.net/2009/02" />

3.运行maven命令。

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

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

应该生成文件

targetclassesapplication.wadl

（WADL本身）和

targetclassesxsd0.xsd

（资源的模式-
它由application.wadl使用）。

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

PS .：请记住，这是对maven-wadl-plugin的非常简单的使用。它可以做的更多。要更好地了解它，请参阅其他答案（由Pavel
Bucek提供）中提到的zip文件。