@ApiModelProperty

`@ApiModelProperty` 是一个用于在 Swagger API 文档中描述模型属性的注释标记。它可以用于指定属性的名称、类型、描述信息、默认值等。

具体来说，`@ApiModelProperty` 注释标记可用于以下属性：

- `value`：属性的简要描述
- `name`：属性的名称
- `dataType`：属性的数据类型
- `required`：属性是否为必需的
- `example`：属性的示例值
- `hidden`：属性是否在文档中隐藏
- `access`：属性的访问级别

例如，下面是一个使用 `@ApiModelProperty` 注释标记来描述一个用户模型属性的示例：

public class User {
    @ApiModelProperty(value = "用户 ID", example = "123")
    private int id;

    @ApiModelProperty(value = "用户名", example = "johndoe")
    private String username;

    @ApiModelProperty(value = "电子邮件", example = "johndoe@example.com")
    private String email;

    // ...
}

这样做可以使生成的 Swagger API 文档更加清晰明了，使得用户更容易理解 API 的使用方式。