Invalid Swagger JSON created for Java methods annotated with same HTTP method and path

[peterjanes]

I believe the following is valid JAX-RS (at least, it works, in my CXF-based service):

@POST
public Response foo(ClassOne body) {...}

@POST
public Response bar(ClassTwo body) {...}

Currently the doclet will produce an operation object for each method, which breaks swagger.js. (The spec says "In the operations array, there MUST be only one Operation Object per method.")

I'm not sure what the correct way to handle this case is; I initially thought of merging the operations, but it's not clear how to do so since the parameters and responses can differ. For now I've hacked the doclet to recognize @ApiOperation(hidden=true) and skip any processing of the method if it's found.