ryankennedy/swagger-jaxrs-doclet — pull request #28 by sldblog (2013-05-30 09:00:36+00:00)
Title: Don't exclude POST parameter with unrecognised annotations

If the POST payload has any kind of annotation, it is not picked up by the doclet, leaving the payload argument undocumented (and therefore untestable in swagger).

We discovered this behaviour when trying to annotate a payload with `@javax.validation.constraints.NotNull`, but it behaves the same for any generic annotation, like `@Deprecated` as well.

----

I had to restructure the `shouldIncludeParameter` method a bit to make this work. If the parameter:
* has an excluded annotation, return `false`
* has an allowed JAX-RS annotation, return `true`
* has no annotations or is a POST method, return `true`
* otherwise return `false`

Could you please confirm that this is the expected behaviour?

Cheers,
David