带有表单url编码的球衣endpointSwager

Question

我有一个DropWizard项目，带有一个简单的表单提交endpoint：

@Path("forms/{form_id}")
@Consumes(MediaType.APPLICATION_FORM_URLENCODED)
@ApiOperation(value = "Submit a form", response = SubmittedForm.class)
@ApiResponses(value = {
    @ApiResponse(code = 200, message = "Valid request - form submitted", response = SubmittedForm.class)
})
public Response submitForm(@PathParam("form_id") String formId, MultivaluedMap<String, String> parameters) {
    ...
}

我正在使用Swagger（swagger-jersey2-jaxrs 1.5.4）来记录我的API。但是，对于此endpoint，没有为表单参数生成文档。如果我更改多值地图

是否有任何方法可以使用Swagger正确记录表单提交endpoint（使用url编码的参数）？




Answer 1

swager规范中不允许使用任意映射，因此在扫描操作时不会检测到该映射。根据规范，Form参数只支持可序列化类型。