Swagger如何与Java枚举结合使用展示字段描述？

Swagger与Java枚举结合展示字段描述主要是通过在枚举成员上添加`@ApiModelProperty`注解来实现的。这个注解允许你控制在Swagger文档中显示的信息，包括字段名、描述、默认值等。

例如：

public enum Status {
    ACTIVE("@status.active", "活动状态", true),
    INACTIVE("@status.inactive", "非活动状态", false);

    private String code;
    private String description;
    private boolean defaultValue;

    Status(String code, String description, boolean defaultValue) {
        this.code = code;
        this.description = description;
        this.defaultValue = defaultValue;
    }

    @ApiModelProperty(
            value = "状态描述",       // 描述
            notes = "这是该状态的详细说明",      // 额外信息
            example = "true" or "false",   // 示例值
            defaultValue = defaultValue,  // 默认值
            code = code                  // 枚举值的唯一标识
    )
    public String getDescription() {
        return description;
    }
}

在这个例子中，`@ApiModelProperty` 中的 `value` 和 `description` 字段用来指定显示的文本描述，`example` 设置了示例值，`defaultValue` 指定了枚举值的默认值，`code` 则是枚举值在Swagger中的标识。

当你运行项目并访问Swagger UI，你会看到这些枚举值及其对应的描述、示例和其他元数据信息清晰可见。