Swagger UI不显示所有标题值

Question

我有一个带有标头的Spring Boot REST控制器，它可以有多个值：

@RestController
@RequestMapping(value = "/example", headers = {"version=v1", "version=v2"})
@Api(value = "Example API")
public class ExampleController {

并使用Springfox实现了Swagger。当我加载Swagger UI时，我只能从版本标题列表中看到并选择v1选项。如何在Swagger UI中显示所有表头值以供选择？如何更改Swagger UI列表中的默认头值？

Answer 1

在控制器方法上使用了ApiInimplentParams：

@ApiImplicitParams({
    @ApiImplicitParam(name = "version", allowableValues="v1,v2", required = false, dataType = "String", paramType = "header")
})

使用允许值：

1. 若要设置值列表，请提供以逗号分隔的列表。例如：第一、第二、第三。
2. 要设置值的范围，请以“range”开头，方括号括起来包括最小值和最大值，或用圆括号表示独占的最小值和最大值。例如：范围[1， 5]， 范围（1， 5）， 范围[1， 5]。
3. 要设置最小值/最大值，请对范围使用相同的格式，但使用“无穷大”或“-无穷大”作为第二个值。例如，范围[1，无穷大]表示此参数的最小允许值为1。