users@jersey.java.net

Re: [Jersey] Extending WADL Questions

From: Martin Grotzke <martin.grotzke_at_freiheit.com>
Date: Tue, 11 Aug 2009 22:34:59 +0200

Hi Tim,

I can reproduce this with the generate-wadl sample of jersey: the
ItemsResource contains a createItem method with a parameter item of type
Item and a corresponding @param javadoc comment. The javadoc stuff shows
up in the resourcedoc.xml but not in the wadl file. This sample instead
shows how to use @request.representation.qname tag (and friends), as
they are described in [1]. These tags are used for the request
representation in the wadl.

What's the wadl that you'd expect for your input parameter?

Cheers,
Martin

[1] http://wikis.sun.com/display/Jersey/SupportedJavadocTagsForExtendedWADL


On Tue, 2009-08-11 at 10:50 -0600, Wright, Timothy M CTR USAF AFMC
AFRL/RDS wrote:
> I have followed the example online to extend the WADL with comments
> from my source code. I can not get any comments for the POST Input.
>
>
>
> Here is my example code:
>
>
>
> /**
>
> @param in The input data
>
> */
>
> @POST
>
> Public void uploadData( InputStream in ) { … }
>
>
>
> The comment, “The input data”, ends up in the resourcedoc.xml file I
> generate with ANT. However, it is missing in the WADL file. All the
> other comments I am adding, such as query parameters, class comments,
> and method comments, are included in the WADL. Is there something
> special I need to do to get this so show up?
>
>
>
> Thanks for your time,
>
>
>
> Tim Wright
>
>
>