A Look Inside the Think Tank...

REST Describe first working Beta released

Created on Thursday, April 26, 2007 at 18:05:54 and categorized as Work by Thomas Steiner

REST Describe first working Beta released

Today I have released version 0.1 of REST Describe (described in an earlier blog post). 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:

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

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

And all this information just from one example request. This is basically what the 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. Marc Hadley has done a great job in defining WADL, the XML-based Web Service description language REST Describe supports.
REST Describe

However, the approach described above has some shortcomings:
REST Describe is developed with the Google Web Toolkit. During development I very often hit the limit of available event management memory and after a few test runs had to restart the hosted Google Web Toolkit Browser. However, besides this annoyance, the toolkit is a real pleasure to use. It allows for completely Java-fied web application development. There are some problems with Trees in ScrollPanels, I hope that with the next release of the toolkit these issues will be resolved.

Click here to check out REST Describe directly in your browser, if you want even in German. In addition to that, the full source code is available under the Apache 2.0 license. Hope you like the release. Feedback and bug reports are warmly welcomed. Please do not hesitate to contact me directly. My contact data are available on this blog.

Update: In order to avoid any confusion I have changed the name of the project, basically I have removed the "Google" from it. Yes, I do work for and get paid by Google for developing this project, but no, the project is not an official Google product. Period.

Please note: REST Describe and REST Compile are no official Google products.

Show/Hide Comment Form | Show/Hide Comments | Permalink