swagger - 带有 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 中，我看到填充了空类型的 List 而不是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) {
}