带有 Jax Rs 资源的集合(列表)输入参数的 swagger ui

Question

如何配置 swaggerui 以显示具有集合输入参数的 JAX-RS 资源的正确参数数据类型？

下面是一个示例 groovy JAX-RS 资源。它的输入类型是 List<User>

@POST
@Produces(APPLICATION_JSON)
@Consumes(APPLICATION_JSON)
@ApiOperation(value = "Create(s) users", response = User, responseContainer = "List")
Response createUsers(List<User> questions) {
}

在 swagger UI 中，我看到填充了空类型的列表而不是 User .它适用于输出参数。使用 ApiOperation注释，我可以指定响应类型。

@ApiOperation(value = "Create(s) users", response = User, responseContainer = "List")

对于输入参数，如何在 swagger UI 中查看用户模型架构列表？

Answer 1

尝试在列表上使用@ApiParam:

@POST
@Produces(APPLICATION_JSON)
@Consumes(APPLICATION_JSON)
@ApiOperation(value = "Create(s) users", response = User, responseContainer = "List")
Response createUsers(@ApiParam("description") List<User> questions) {
}