Java枚举类可通过私有构造方法为常量绑定不可变字段，支持多种类型及函数式接口；需配合静态查找方法与JSON注解确保序列化一致性。
Java中枚举类可以通过构造方法为每个枚举常量绑定自定义属性字段，这是最常用且推荐的方式。
定义带参数的构造方法
枚举类本质上是特殊的类，支持私有构造方法和字段。你需要声明私有字段、提供构造方法，并在枚举常量定义时传入对应值。
- 字段必须用private final修饰（保证不可变性）
- 构造方法必须是private（枚举不允许外部实例化）
- 每个枚举常量后跟括号，传入构造方法所需的参数
示例：
public enum Status {
SUCCESS(200, "操作成功"),
NOT_FOUND(404, "资源未找到"),
SERVER_ERROR(500, "服务器内部错误");
private final int code;
private final String message;
// 私有构造方法
Status(int code, String message) {
this.code = code;
this.message = message;
}
// 提供公共 getter 方法
public int getCode() { return code; }
public String getMessage() { return message; }
}
支持多种类型和复杂属性
自定义字段不限于基本类型或字符串，也可以是对象、集合甚至函数式接口。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- 例如绑定一个处理逻辑：用Supplier<String>或Function<Object, String>
- 可组合多个字段，如int code、String desc、boolean retryable
- 注意：避免在枚举中持有可变对象引用（如ArrayList），否则可能破坏单例语义
配合静态工具方法增强可读性
常通过静态方法根据属性反查枚举常量，比如按 code 查 Status。
- 使用static Map缓存提升性能（尤其枚举项较多时）
- 建议在静态代码块中初始化映射，或用Stream + Collectors.toMap（Java 8+）
- 找不到时应明确抛出异常（如IllegalArgumentException）或返回Optional
示例查找方法：
public static Status fromCode(int code) {
for (Status status : values()) {
if (status.code == code) {
return status;
}
}
throw new IllegalArgumentException("Unknown status code: " + code);
}
注意序列化与反序列化一致性
如果枚举用于 JSON 或 RPC 场景，需确保自定义字段能被正确序列化，且反序列化后仍能准确还原枚举实例。
- 大多数 JSON 库（如 Jackson）默认只序列化枚举名称，如需输出字段，需加注解（如@JsonValue指定方法）
- 反序列化时，建议用@JsonCreator标注静态工厂方法，避免直接依赖 name 或 ordinal
- 不要重写readObject或writeObject——枚举的序列化机制由 JVM 保障，手动干预易出错
