Welcome to the Web Application Description Language (WADL) project at Java.net. This project is under the CDDL license. Here you'll find the language specification and tools for working with WADL descriptions of Web applications.

WADL Specification

History (current specification at top):

wadl2java

The latest distribution can be downloaded here.(Version 1.1.6, Feb 2014)

The distribution contains the following tools that will generate client from a WADL for both Jersey 1.x and Jersey 2.x. It will generate binding objects based on referenced XML Schema, JAX-B binding, or JSON Grammar using Jackson based mappings.

wadl-xslt
A collection of useful .xsl transforms including: one to upgrade '2006 WADL to '2009 WADL; and one to generate a HTML description of the WADL.
wadl-cmdline
A command line tool that generates client side stubs from WADL files, see the wadl2java documentation for full details.
wadl-ant
An Ant plug-in that generates client side stubs from WADL files, see the wadl2java documentation for full details.
wadl-client-plugin
A Maven plug-in that generates client side stubs from WADL files, see the wadl2java documentation for full details.
wadl-dist
Sample projects that demonstrate use of the wadl2java tools to create stubs for the BBC Schedule API.

Other Resources

wadl_documentation.xsl
Mark Nottingham has created a project to develop XSLT stylesheets to transform WADL documents into human-readable documentation.
wadl.xsl
Mark Sawers has published an alternative XSLT stylesheet to transform WADL documents into human-readable documentation.
wadl2java
The Apache CXF project has a tool also called wadl2java that generates for both the client and the service.
jsonschema2pojo
The jsonschema2pojo project used to generate the JSON Schema binding classes.
Swadl
Wadl documentation generator, see https://github.com/ehearty/Swadl for more details.

Contributing to the Project

Contributions are welcome in the following areas:

  • Suggestions for improvements to the current tools. These can be in the form of:
    • Bug reports
    • Feature requests
    • Source code patches
  • Suggestions for improvements to the WADL specification
  • Submission of WADL files for existing Web applications
  • Submission of new tools
  • Documentation or tutorials on the use of WADL or the tools under development here.

Project Build Instructions

Netbeans

You need Maven 2 to build the code contained within this project. Java SE 6 or later is required. First check out the workspace:

$ svn checkout https://svn.java.net/svn/wadl~svn/trunk/wadl wadl --username yourid

where yourid is your java.net user id.

Go to the project root directory and build the project:

$ cd wadl
$ mvn package

The complete distribution will be built in:

wadl-dist/target/wadl-dist-1.1.6-SNAPSHOT-bin.zip

After unpacking the distribution, see the content of the samples directory for examples of how to use wadl2java from the command line, from Ant and from Maven.

Terms of Use; Privacy Policy; Copyright ©2013-2014 (revision 20140418.2d69abc)
 
 
Close
loading
Please Confirm
Close