users@jersey.java.net

[Jersey] WADL Javadoc tag issue

From: Roland Müller <rmueller83_at_googlemail.com>
Date: Wed, 10 Aug 2011 11:43:59 +0200

Hi,

I'm trying to generate a WADL description similar to the one in the
Atom example of the WADL specifiaction:
http://www.w3.org/Submission/wadl/#x3-36000A.2

For the POST response, they have the following description:

<response status="201">
  <param name="location" style="header" type="xsd:anyURI" required="true">
    <link resource_type="#entry" rel="self"/>
  </param>
  <representation href="#entry"/>
</response>

Trying to reproduce this within Jersey's generate-wadl sample by using
the tags described in
http://wikis.sun.com/display/Jersey/SupportedJavadocTagsForExtendedWADL
, I use the @response.param annotation on the @POST annotated method
to specify the <param ...> tag. But if I additionally use
@response.representation.201.doc to define the response status code,
the <param ...> stuff is not visible any more in the generated WADL
output. It seems that @response.param and @response.representation are
mutually exclusive.

So, how can I specify both a <param> tag and a status code in the
response description, similar to the specification's example?

Greetings,
Roland