ParameterIn.formData / @FormParam?

[ghost]

Some example method:

@POST
@Path("/testing")
@Consumes(MediaType.APPLICATION_FORM_URLENCODED)
public Response myMethod(
  @Parameter(in = "formData", description = "Testing")
  @FormParam("data") final String data) {
  ...
}

Problem:

• @Parameter "in" does not allow arbitrary strings
• Not able to use @FormDataParam (not available)
• When @Parameter(in = ParameterIn.X) is not defined
  • Parameter is resolved as @RequestBody (because of @POST)
  • For some reason, descriptions and required indicators are not shown in Swagger UI

How do I manage to show the @FormParam as formData parameter in Swagger UI? Thank you in advance.

[pioto]

I can confirm this issue.

A combination of @Consumes(MediaType.APPLICATION_FORM_URLENCODED) on the method, and @FormParam("data") on the parameter, does get Swagger UI to mostly generate thr right sort of thing, but if I add @Parameter to that parameter, my description does not appear, and doesn't seem to be copied over in the way that would be expected from https://swagger.io/specification/#support-for-x-www-form-urlencoded-request-bodies

[AndrewBoyarsky]

I have the same bug, @Parameter + @FormParam does not show description, provided in the @Parameter

[frantuma]

partially addressed by #3696