java - 如何为请求参数允许多个预定义（枚举）值？

Question

我想接收查询字符串参数的多个值，例如：

/api/assets?category=light&category=heavy

同时将允许的值限制为预定义的集合。

我已经找到了如何限制允许的值，现在如何允许输入多个值？

这是我当前的代码：

public ApiRespSuccess<List<AssetApi>, ApiMetadataPagination> getAssets(
        @RequestParam @Parameter(schema=@Schema(description="param-desc", type="string", allowableValues= {"positioning", "energyReport"})) List<String> withExtFeature,
        @ParameterObject RequestPagination pagination) {
        // ...

如果我删除 @Parameter 注释，swagger-ui 会显示一个“添加项目”按钮。

Answer 1

这是实现目标的语法：

@GetMapping("/test")
public SampleDTO getFile(@RequestParam @Parameter(array = @ArraySchema(schema = @Schema(type = "string", allowableValues= {"positioning", "energyReport"})), description="param-desc") List<String> withExtFeature){
    return null;
}