users@jersey.java.net

WADL generation and required param

From: Martin Grotzke <martin.grotzke_at_freiheit.com>
Date: Thu, 26 Jun 2008 20:33:04 +0200

Hi jersey devs,

a wadl param has the attribute "required". The wadl generator right now
does not set this attribute, as this would only be possible for
primitives. For complex types (e.g. string) the generator does not have
the possibility to determine, if a parameter is required or not.

We see these options:
1) Add an attribute "required" to @*Param
   a) This can be interpreted by implementations, so that for required
      but missing params s.th. like status 400 would be returned,
      without invoking (the users) resource method
   b) This would require negotiation with jsr311 board
2) Add an annotation @Required to jersey
   a) This can be interpreted by jersey, so that for required
      but missing params s.th. like status 400 can returned, without
      invoking (the users) resource method
   b) Is s.th. like this possible without breaking jsr311 compliance?
3) Add some javadoc tag like @param.{paramname}.required that is just
   used for wadl generation and does not affect any runtime behavior.

What would you say is desired here?

Cheers,
Martin