WADL - Web Application Description Language

Businesses and enterprises, for their web apps and other digital identities, use HTTP-based resources to gain streamlined access for viewing the internal data and carrying out the operations on (or using) it. These HTTP-based resources/applications deploy text-based documents to data representation.
WADL acts as a means between the data and end-users to make sense out of HTTP-based app data. Read this article to understand what it is and whatās its significance in an elaborated manner.
What is WADL?
WADL is the language instructed for explaining the traits or segments of HTTP web solutions/applications. Description of the appās all HTTP resources alongside their correlations and dependencies can be provided using it.Ā
The language intends to make HTTP web services simplified up to such an extent that understanding the core architecture and processing is not complex for end-users and other machines while promoting application reuse. Unlike other languages, WADL is yet to be standardized by the World Wide Web Consortium.Ā
The distinguishers of WADL scope are provided below -
- The WADL-provided description is available only in machine-compatible XML.
- Used mainly to describe RESTFul application components. What WDSL does for SOAP, WADL does the same for REST.Ā
- WADL works without platform and language restrictions.
- It takes multiple sets of resource elements to provide insightful web app descriptions.

The main elements of WADL
The key WADL defining elements are listed as under:
- Resource
With this component, WADL explains the URI-identified resources.Ā
This element features an xsd:anyURI typed base attribute and operates or behaves like a container for all the application-offered resources. The base attribute of this element proffers the fundamental URI for every included child resource identifier.
Here are the key attributes of this element:
- āid - Optional type xsd: ID attribute helps in identification of resources.
- āpath - Optional type xsd: string attribute that offers URI template for resource identifier, when active/present.Ā
- ātype - Another optional attribute related to xsd:anyURIās separate list type. Every mentioned list value is a cross-reference explaining the resource_type element.Ā
- āqueryType - Used to explain the media type of query element concerning resource URIs.
Other than all the above-mentioned attributes, āresourceā also has many other child elements like any number of doc and param elements, template, matrix, header, and query.Ā
- Method
This WADL description element refers to the input provided and output received via HTTP, implemented to a given resource. Its key child elements are -
- ādoc - There might be none or multiple doc elements. It is the attribute for documentation related to āmethodā.Ā
- ārequest elaborates HTTP methodās input that mostly compromises a collection of parameters.
- āresponse is the output value received through the method, HTTP. Its value could be zero or more, based upon the inputs offered.Ā
Method attribute exists in two forms: method definition and method reference. At a time, only one form exists.
Method Reference
It is an offspring of href attributing resource element with a type value of xsd:anyURI. Here, the href attribute value acts out as the method definition elementās cross-reference.Ā
Any other WADL-based attribute or child elements shouldnāt be included in the method reference. Speaking of the utility, method reference is used to prevent method duplication when itās applied to multiple resources at a time.Ā
Method DefinitionĀ
A child of the application or resource element, this second type has attributes as enlisted below:Ā
name refers to the deployed HTTP method. Various child method elements can feature similar name values. Such child elements are known as siblings and will inherit the different variations of one identical HTTP method. Siblings will have distinct input values.Ā
id is the method identifier essential for defining widely adopted defined methods. Locally embedded methods donāt feature an id. The id is XML id and indicates URI reference usage.Ā
- Request
With the help of this element, WADL explains the input used for the HTTP method. It contains no attributes, but a few child elements such as doc, representation, and param elements.Ā
All these child elements could feature zero or more value.Ā
Responseās param will feature a query or header value. It will be added to the style attribute.
- Response
A part of various attributes that define WADL, response signifies the output received for an HTTP request sent. In return, it receives just 1 attributeās value, i.e. Status. Status is non-compulsory and offers the HTTP status codes that are linked with a specific response.Ā
Its children elements are as listed below:
- doc element that is optional component.
- representation may have zero or multiple values. Each representation value indicates the resource representation of the result incurred after method implementation. There are sibling representation elements as well that signifies the logical alternatives of normal HTTP content.
- param element features zero or many values. Each value holds the style attributeās header data.
- Parameter
Parameter or param element can be a parameter definition or a reference and indicates the parent elementās parameterized value.
Parameter Reference
This type of param element features href attribute with xsd:anyURI type value.Ā
href is the cross-reference for the param definition element. It is a standard practice to exclude WADL-defined attributes or child elements from it, considering its cruciality. Itās most commonly used for trimming the duplicates in scenarios where a parameter is applied to multiple parents.Ā
Parameter Definition
It explains the parameterized value of elements, like a parent element or a resource child. Other than this, param definition is also used for representation, application, response, and request elements.Ā
This element features:Ā
- doc child element, either zero or many.Ā
- None or multiple children (optionally)
- Non-compulsory link child element.Ā
The key attributes of these elements are id, name, style, type, default, path, required, repeating, and fixed.Ā
Other than id, name, and style, the rest are optional attributes.Ā
WADL Example

WSDL vs WADL
As both WADL and WSDL are the contracts/interfaces for web services and are used in almost similar situations, itās crucial to figure out the differences between these two for effective usage.Ā
Before delving deep to figure out the differences, understand one key similarity that is both acts as a bridge between the server and the clients and are responsible for data transfer.
What is WADL in RESTful service?
In simple words, it is the XML description comprising the details of the app's structure, media extensions, and resources alongside the HTTP requesting methods. To understand it better, try doing this for a REST solution:
- Select the REST service option and pick the āsample-serviceā from the available menu.
- In the newly-opened wizard, expand the menu.
- From here, select the preferred Service Endpoints.
- Look for the option āWADLā and choose āContent.ā
this way, you will be able to view opened RESTful appās description and take its reference.
Conclusion
Employed widely to illustrate the utilities and characteristics of HTTP-driven web services, WADL is assisting web applications like Flickr, Google, and Yahoo greatly. Knowing about WADL in detail will help you reuse these apps and services better. You can even convert this file to WADL JSON format and use it more conveniently.
FAQ
References
Subscribe for the latest news