swagger 参数为List

当接口参数为 `List` 类型时，Swagger 可以通过 `@ApiParam` 或 `@ApiModelProperty` 注解对参数进行描述。

下面是一个使用 `@ApiParam` 注解描述 `List` 类型参数的示例：

@ApiOperation("添加用户")
@PostMapping("/users")
public ResponseEntity<String> addUser(
    @ApiParam(value = "用户列表", required = true) @RequestBody List<User> userList) {
    // ...
}

在上面的例子中，使用 `@ApiParam` 注解对 `userList` 参数进行描述，指定了参数的名称、是否必填、数据类型等信息。

如果需要对 `List` 中的元素进行描述，可以在 `User` 类中使用 `@ApiModelProperty` 注解描述具体的属性，例如：

public class User {
    @ApiModelProperty(value = "用户名", example = "张三")
    private String username;

    @ApiModelProperty(value = "年龄", example = "18")
    private Integer age;
    
    // 省略 getter 和 setter 方法
}

另外，如果需要对 `List` 类型的参数进行更加详细的描述，可以在 `@ApiParam` 或 `@ApiModelProperty` 注解中使用 `dataType` 属性指定元素的类型，例如：

@ApiParam(value = "用户列表", required = true, dataType = "User", allowMultiple = true)

这样就可以在 Swagger 文档中清晰地展示出参数的类型和元素的属性信息。