title: Annotating @FormParam fields with Swagger-UI @ApiParam
body: <p>I have built a <em>RestEasy API</em> and linked it with <em>Swagger UI</em>. A task I have been asked to complete is to, find a way to reduce the query parameters in the method signature and handle them in some sort of "DTO".</p>
  
  <p>My <strong>original implementation</strong> would be similar to:</p>
  
  <pre><code>  @GET
    @ApiOperation(value = "echo test value", notes = "echo test notes")
    @ApiResponse(code = HttpServletResponse.SC_OK, message = "Response.status.OK")
    public Response echoTest(
      @ApiParam("id") @QueryParameter("id") final int id,
      @ApiParam("fName") @QueryParameter("fName") final String fName,
      @ApiParam("sName") @QueryParameter("sName") final String sName) {
  
      // handle request
  
    }
  </code></pre>
  
  <p>I have extracted the query-parameter handling to a DTO, although now I am unsure how to handle the Swagger-UI side of things. I have tried to annotate the fields in the DTO athough as I guessed, this did not work. My <strong>current solution</strong> without correct swagger-ui interaction:</p>
  
  <pre><code>  @GET
    @ApiOperation(value = "echo test value", notes = "echo test notes")
    @ApiResponse(code = HttpServletResponse.SC_OK, message = "Response.status.OK")
    public Response echoTest(@ApiParam("form") @FormParam QueryDTO dto) {
  
      //Handle request
  
    }
  </code></pre>
  
  <p><strong>QueryDTO.java:</strong></p>
  
  <pre><code>public class QueryDTO {
  
    @ApiParam(name = "id", value = "user id") @QueryParam("id") private int id;
    @ApiParam(name = "fName", value = "user first name") @QueryParam("fName") private String fName;
    @ApiParam(name = "sName", value = "user surname") @QueryParam("sName) private String sName;
  
    // Getters,setters etc
  
  }
  </code></pre>
  
  <p>Does SwaggerUI support this type of feature? Is there an alternative approach I could take which would suit my use case? Any suggestions or help is appreciated, thanks.</p>