users@jersey.java.net

[Jersey] Re: WADL Javadoc tag issue

From: Pavel Bucek <pavel.bucek_at_oracle.com>
Date: Mon, 15 Aug 2011 03:04:26 +0200

Hello Roland,

congrats, you've found a bug!

After a brief investigation I found that it can be fixed by simply
commenting out line 258 in WadlResourceDocSupport class from
jersey-server, but I'll need to verify this little more thoroughly. Can
you please file new issue?

Thanks,
Pavel

On 8/10/11 11:43 AM, Roland Müller wrote:
> 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
>