These days I am dealing a lot with the WADL spec (PDF). WADL is one of the mightiest Web Service description languages out there. With the announcement of the release of the new GData API for Picasa Web Albums, the language's potential to describe features that are not known until run time will be put to the utmost. Imagine you want to describe a request like this:
There are a whole bunch of unknown path variables inside of the request URI:
Anyway, on my way to doing this in an automated way, I moved another small step forward today. Have a look at the screenshot below: now there is one of these fancy in-application windows. This allows for different parameters to be tested directly from within REST Describe which can then be accepted for further analysis. What does the app do so far?
- It resolves the URI and extracts
- the endpoint
- the request name
- the request parameters
- the fragment
- It then analysis the request parameters and does basic type guessing based on regular expressions
- TODO: It then builds an XML document tree that will be the basis for the final WADL document
Please note: REST Describe and REST Compile are no official Google products.
Image from lederhosen-aigner.de