Web Application Description Language Tool (Wadl.exe)
The Web Application Description Language tool generates code for RESTFul Web services and RESTFul Web service clients from WADL contract files.
A .wadl file is an XML document written in an XML grammar called Web Application Description Language (WADL). This file defines how an REST based Web service behaves and instructs clients as to how to interact with the service. When you use Wadl.exe to create a proxy class, a single source file is created in the programming language that you specify. In the process of generating the source code for the proxy class, the tool determines the best type to use for objects specified in the service description.
wadl: Web Application Description Language (WADL) - Specification ...
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 ...
Web Application Description Language (WADL) https://wadl.dev.java.net/wadl20061109.pdf
The WADL specification (PDF) and WADL schema describe the features of the language in detail but a few points are worth highlighting:
*Generative URIs are handled by including support for parameterization of URI components.
*The base set of HTTP methods (GET, POST, PUT, DELETE, HEAD) are specifically supported by the WADL schema but the method enumeration is open to use with other methods such as those specified by WebDAV.
*Representation parameters are hints to processors that point out interesting parts of a resource representation. As such they may be used or ignored as desired. I think they'll be useful for RPC-like interactions but less so for more document oriented work.
*Sibling representation elements represent alternative representations of the same resource. This means you can describe a resource that is offered in alternate formats, e.g. XML or HTML.
*The design center is XML/HTTP but this doesn't preclude use with alternate representation formats: the representation/@mediaType attribute provides the necessary hook.