ApiModelProperty List注解

如果需要在 API 文档中对包含对象的列表类型参数进行描述，可以使用 `@ApiModelProperty` 注解对列表属性进行描述。

例如，如果需要描述一个包含 `User` 对象的列表类型参数，可以这样写：

@ApiModelProperty(value = "用户列表参数", dataType = "List", allowMultiple = true)
private List<User> userListParam;

其中，`dataType` 属性指定了列表元素的类型为 `List`，`allowMultiple` 属性指定了该参数是一个列表类型。

需要注意的是，如果需要对 `User` 对象中的属性进行描述，应该在 `User` 类中使用 `@ApiModelProperty` 注解进行描述，而不是在列表属性上使用 `@ApiModelProperty` 注解。

另外，如果 `allowMultiple` 属性设置为 `false`，则表示该参数不是一个列表类型，而是一个单独的对象。在这种情况下，可以省略 `dataType` 属性，并在 `@ApiModelProperty` 注解中对该对象的属性进行描述。例如：

@ApiModelProperty(value = "用户参数")
private User userParam;

然后在 `User` 类中对属性进行描述：

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

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

这样，在生成 API 文档时，就会根据 `@ApiModelProperty` 注解生成相应的文档描述信息。