spring-boot - 使用带有 swagger ui 的 @RequestParam 注释方法

Question

我正在使用 Springfox库来为 REST 服务生成文档并将其显示在 Swagger UI 中。我按照 Springfox documentation 中的说明进行操作.

我有一个 Controller ，它使用查询字符串中的参数，该方法映射如下:

@ApiOperation(value = "")
@RequestMapping(method = GET, value = "/customcollection/{id}/data")
public Iterable<CustomeType> getData(@ApiParam(value = "The identifier of the time series.") 
    @PathVariable String id,
    @ApiParam(name = "startDate", value = "start date", defaultValue = "")
    @RequestParam("startDate") String startDate,
    @ApiParam(name = "endDate", value = "end date", defaultValue = "")
    @RequestParam("endDate") String endDate)

swagger-ui 中生成的映射器然后显示为:

GET /customcollection/{id}/data{?startDate,endDate}

参数在 UI 中正确显示:

但是当我点击 Try it Out 时，请求 URL 格式错误:

http://localhost:8080/customcollection/1/data {?startDate,endDate}?startDate=1&endDate=2

如何修复？

Answer 1

这是由线路引起的

 enableUrlTemplating(true)

在 Docket我从示例中复制并忘记删除的配置。

删除此行后，一切都按预期工作。