Friday, April 27th, 2007

REST Describe WADL toolkit

Category: GWT, Showcase

<p>Thomas Steiner has released REST Describe, a GWT application, open-sourced, that groks WADL:

The application is based on the idea that creating a description for a Web Service should be a rather simple task given the information already contained in requests. Let’s take a very simple imaginary online bookmarking Web Service to make the idea clear:

http://bookmarks-online.com/api/v1/getBookmarks?userId=tom&tags=rest&limit=10

Simply by looking at the URI we can extract the following information:

  • http://bookmarks-online.com: there is a Web Service at this base address.
  • /api/v1/: this is the path to access the service components.
  • getBookmarks: there is an operation called getBookmarks
  • ?userId=tom&tags=rest&limit=10: it takes three arguments, userId, tags, and limit. When we have a closer look, we could guess that “userId” and “tags” are both strings, and that “limit” is an integer value.

And all this information just from one example request. This is basically what the Google REST Describe approach is based on. It takes an ideally complete list of URIs, analyzes the structure, does some type estimations, and afterwards creates an XML representation of the request.

REST Describe

Related Content:

Posted by Dion Almaer at 1:23 am
2 Comments

+++--
3.2 rating from 22 votes

2 Comments »

Comments feed TrackBack URI

this is rather cool and actually useful, isn’t it? thx for this!

Comment by britneyfreek — April 27, 2007

so what’s wrong with wsdl?

Comment by Jaimz — April 30, 2007

Leave a comment

You must be logged in to post a comment.