InfoQ

News

WADL REST API description language getting some attention

Posted by Geoffrey Wiseman on Mar 19, 2007 03:13 PM

Community
SOA
Topics
Web Services ,
REST
Tags
WSDL ,
WADL
To define and describe a web-service API, many developers would use WSDL. Although WSDL is meant to be extensible to any protocol and message format, most people use it for HTTP GET/POST and SOAP, when writing to WS-* standards.  On the other hand, developers writing a REST API using XML over HTTP typically don't use WSDL, or any other standardized definition/description of the API.  There will usually be some kind of human-readable documentation, but that's as far as it goes.

Not everyone is convinced that we need to describe and define REST-ful APIs, but there are those who believe it's useful.  Tim Bray suggests that it's what we need to allow users to consume an XML/HTTP API in a few lines of code.  It's certainly true that machine-readable descriptions of web APIs can allow the generation of a language-specific library.

For those who would like to describe their XML over HTTP service, a lot of options have been discussed, from SMEX-D (proposed by Tim Bray) to NSDL, and a host of alternatives. However, most of those proposals were made in 2005 or earlier, and since then none has really seen much adoption.

Marc Hadley (one of the Spec Leads for JSR-311, a Java API for RESTful services) back in 2005 proposed  WADL, the Web Application Description Language.

Since then, a number of people have been building tools to support WADL. Yahoo architect  Mark Nottingham is maintaining a stylesheet to generate documentation from WADL.

Last week, Google's Thomas Steiner unveiled that he is working on a Google project for generating language specific client libraries from WADL and generating WADL from documentation examples, tentatively called Google REST Compile and Google REST Describe.  Thomas chose WADL as the description language to be used with the new tool, after examining all the alternatives

The Sun Developer Web Pack was also released last week and contains prebuilt binaries of some WADL tools developed by Marc Hadley.

With architects at Yahoo, Google, and Sun choosing WADL for their REST tooling, perhaps WADL will receive more adoption. For more information on WADL, the reasons behind it and the alternatives, Marc Hadly's presentation (PDF, Google's HTML translation) is a good overview. 

10 comments

Watch Thread Reply

WSDL by Nikolai Ivanov Posted Nov 24, 2007 9:51 PM
I would stay with WSDL by Frank Thompson Posted Nov 27, 2007 6:17 PM
Re: I would stay with WSDL by emrah okay Posted Apr 30, 2009 10:44 PM
Re: WADL usage and associated benefits by Don Holloway Posted Dec 2, 2007 10:35 AM
Re: WADL usage and associated benefits by mike gracia Posted Dec 15, 2007 9:29 AM
implemention of WADL by Jon chritz Posted Jan 30, 2008 9:36 AM
Re: implemention of WADL by emrah okay Posted Jun 19, 2009 7:22 AM
implemention of WADL by Jon chritz Posted Jan 30, 2008 9:41 AM
WADL to describe interaction, not services. by William Martinez Posted Mar 23, 2008 8:12 PM
Re: WADL to describe interaction, not services. by emrah okay Posted Apr 12, 2009 11:53 PM
  1. Back to top

    WSDL

    Nov 24, 2007 9:51 PM by Nikolai Ivanov

    Many companies use XML and HTTP with no WSDL. Why bother? Thanks. http://www.1qcc.com

  2. Back to top

    I would stay with WSDL

    Nov 27, 2007 6:17 PM by Frank Thompson

    I understand the benefits of defining a standard, but it does not always mean that a standard will become widely adopted, instead, some de-facto standards can be very popular and widely accepted and implemented, for example, TCP/IP. Our goji berries website uses XML over HTTP without WSDL, as it is simple to declare the services, and is simple for users to call the services.

  3. Back to top

    Re: WADL usage and associated benefits

    Dec 2, 2007 10:35 AM by Don Holloway

    Andrew, thanks for the quick note. I've been working on a project to add some more utility to the concert and festival listings at http://www.websortings.com. Basic webpage listings for festivals aren't very good by themselves without date and location data for the actual event. I had done some research, and found some graduate research http://ils.unc.edu/MSpapers/2830.pdf done by Michael Graves at the University of North Carolina. He did a good job of defining the data schema, etc. But was recommending using RDF/XML. He recommended an ontology called OWL to define the event. I was fine with the data, sources, etc. but kind of got confused at the OWL layer. I do want the concert and event data to be available and accessible to outside applications, so it looks like WADL will provide a much simpler way to make sure that the data is structured properly. I read through the Sun power point presentation and it seems pretty straightforward. If it continues to be supported by Google, Sun, et all, it should be a pretty safe choice. Don

  4. Back to top

    Re: WADL usage and associated benefits

    Dec 15, 2007 9:29 AM by mike gracia

    I found this post very interesting... I have used WADL for http get and http post... I think I willneed to re-read this a few times really! Ethical

  5. Back to top

    implemention of WADL

    Jan 30, 2008 9:36 AM by Jon chritz

    Our small firm tried to implement it by ourself with no success. we had to hire and outside consultant. We want more hand on manual and sample project outline.

  6. Back to top

    implemention of WADL

    Jan 30, 2008 9:41 AM by Jon chritz

    Our small firm tried to implement it by ourself with no success. we had to hire and outside consultant. We want more hand on manual and sample project outline. http://www.haitianite.com/main/

  7. Back to top

    WADL to describe interaction, not services.

    Mar 23, 2008 8:12 PM by William Martinez

    I wrote a couple of blogs(A RESTFull WSDL?,WADL, REST and WSDL,WSDL 2.0 - a REST Friendly Language) about the need of a service message description for REST. One solution is actually WSDL, and WSDL 2.0 may even fit better. There I explain that WADL, to me, it not a clear way to describe a service, but it is more a detailed way to describe interaction. The level is lower than describing a web service, and thus closer to implementation than to contract description. Following this, WSDL is not replaced by WADL, but may be complemented by it. A WSDL may define the service, and a WADL generated from it to actually describe a REST implementation of the web service. William Martinez

  8. Back to top

    Re: WADL to describe interaction, not services.

    Apr 12, 2009 11:53 PM by emrah okay

    With twenty-four members plus two spec leads, Java EE 6 -- or JSR-316 -- is officially underway, Roberto Chinnici presents a summary from the first meetings between the group saç  video izle program indir indir amerika Sohbet adana Sohbet izmir Sohbet Ağrı Sohbet aksaray Sohbet almanya Sohbet Adıyaman Sohbet Afyon Sohbet ankara Sohbet Antalya Sohbet istanbul Sohbet Afyon Sohbet Afyon Sohbet Haber Haber oyun indir oyun indir sohbet mp3 indir bedava film izle bedava film izle telefon çet oyun indir indir program indir - chat anyone try to appropriate the IP and patent it without OpenID's consent.

  9. Back to top

    Re: I would stay with WSDL

    Apr 30, 2009 10:44 PM by emrah okay

    With twenty-four members plus two spec leads, Java EE 6 -- or JSR-316 -- is officially underway, Roberto Chinnici presents a summary from the first meetings between the group saç  video izle program indir indir amerika Sohbet adana Sohbet izmir Sohbet Ağrı Sohbet aksaray Sohbet almanya Sohbet Adıyaman Sohbet Afyon Sohbet ankara Sohbet Antalya Sohbet istanbul Sohbet Afyon Sohbet Afyon Sohbet Haber Haber oyun indir oyun indir sohbet mp3 indir bedava film izle bedava film izle telefon çet oyun indir indir program indir - chat anyone try to appropriate the IP and patent it without OpenID's consent.

  10. Back to top

    Re: implemention of WADL

    Jun 19, 2009 7:22 AM by emrah okay

    With twenty-four members plus two spec leads, Java EE 6 -- or JSR-316 -- is officially underway, Roberto Chinnici presents a summary from the first meetings between the groupmetin 2 indir video izle oyun indir bedava sohbet mp3 indir bedava film izle oyun indir indir program chat anyone try to appropriate the IP and patent it without OpenID's consent. --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- With twenty-four members plus two spec leads, Java EE 6 -- or JSR-316 -- is officially underway, Roberto Chinnici presents a summary from the first meetings between the group saç  video

Educational Content

Bindings, Platforms, and Innovation

This presentation focuses on the Internet and separating myth from fact, history from the future, and the mundane from the imaginative. Bob Frankston presents a vision of what could and should be.

Orchestrating Long Running Activities with JBoss / JBPM

This article explores the use of JBoss and jBPM to implement design solutions that effectively address the issue of orchestrating long running activities.

Neo4j - The Benefits of Graph Databases

This presentation covers the use of graph databases as an optimal solution for data that is difficult to fit in static tables, rapidly evolving data or data that has a lot of optional attributes.

Realistic about Risk: Software development with Real Options

This session introduces Real Options and shows how it can help in running your project. Real Options is a decision-making process that can be used to manage risk.

Communication Flexibility Using Bindings

This article discusses the use of bindings on services and references (including the instance of non-configured bindings) as the means to implement SCA communications in a Web and SOA environment.

Writing DSLs in Groovy

After a short introduction to DSLs, Scott Davis plays with the keyboard showing how to approach the creation of a DSL by typing working snippets of Groovy code that get executed.

Scaling Agile with C/ALM (Collaborative Application Lifecycle Management)

IBM Rational and InfoQ present, Scaling Agile with C/ALM, an eBook showing organizations how to become “finely tuned software delivery machines” by enabling team integration and scaling.

Concurrent Programming with Microsoft F#

Amanda Laucher presents a real life enterprise application written in F#. She shows actual code snippets, explaining design decisions and suggesting how to use some of the F# constructs.