users@wadl.java.net

RE: WADL spec clarification

From: Hadley, Marc J <mhadley_at_mitre.org>
Date: Thu, 9 Sep 2010 11:23:05 -0400

I assume you are trying to describe a representation that contains a Boolean - right ?

I think a better way to represent this would as follows:

<representation mediaType="text/plain">
  <param name="result" type="xsd:Boolean" style="plain"/>
</representation>

It might be worth considering switching from text/plain to something with a bit more structure. E.g. you could use application/x-www-form-urlencoded: instead of a body of "true" you'd send back "result=true". That little bit of extra structure will allow you to add additional information in the future with less chance of breaking (well written) clients. In that case you'd use style="query" in the param element. Personally I'd use JSON or XML but I understand the urge to keep things simple.

Marc.

From: Gilgal Jones [mailto:gilgalut_at_gmail.com]
Sent: Thursday, September 09, 2010 10:31 AM
To: users_at_wadl.dev.java.net
Subject: WADL spec clairification

I was wondering if it is accecptable when generating a WADL to use @element="xsd:boolean" for non xml
representations. It would look something like this:
<representation mediaType="text/plain" element="xsd:boolean"/>
rather than referencing an object in the grammars section.

Thanks,
Gil