是否有一个工具可以将Java文件描述为REST服务作为参数,并生成一个wadl文件。
答案 0 :(得分:20)
我遇到了同样的问题:使用RESTeasy并希望找到一种自动生成WADL的方法。
做了一些研究并找到了以下解决方案。
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)。
创建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" />
转到项目文件夹并运行以下命令:
$ mvn compile com.sun.jersey.contribs:maven-wadl-plugin:generate
应该生成文件\target\classes\application.wadl
(WADL本身)和\target\classes\xsd0.xsd
(资源的模式 - 它由application.wadl使用)。
根据需要编辑和使用它们。
PS:请记住,这是maven-wadl-plugin的一个非常简单的用法。它可以做更多。要更好地了解它,请参阅另一个答案中提到的zip文件(由Pavel Bucek提供)。答案 1 :(得分:3)
是的,请参阅Jersey样本的generate-wadl [1]样本(查找maven-wadl-plugin)。