如何使用 OpenAPI 3 流浪汉批注指定列表

Question

对于我的 API，我正在制作一个元注释来处理 Pagable 参数，为此，我需要将字符串列表注释为将在 Swagger UI 中显示的参数。

import io.swagger.v3.oas.annotations.Parameter;

@Parameter(name = "sort", in = ParameterIn.QUERY, schema = @Schema(implementation = String.class, type = "query"))
public @interface PageableQueryParameters {}

为了在 Spring 的 Pageable 中按多个条件进行排序，排序参数需要以字符串列表的形式提供。不幸的是，我不知道如何将排序参数声明为列表。

如何使用斯瓦格的 OpenAPI 3 注释来记录字符串列表？

Answer 1

< code > Schema = @ Schema(implementation = string . class，type = "query"

应改为

数组 = @ArraySchema（实现 = 字符串.class）