Java枚举持久化需自定义code/desc字段并显式转换：JPA用AttributeConverter映射，MyBatis-Plus用@EnumValue注解；禁用ORDINAL，优先存业务稳定的自定义code。
Java 枚举在数据库持久化中，不能直接靠默认行为存“编码”或“描述文本”，必须借助自定义属性 + 显式转换机制。核心是两步：枚举类里封装好 code/desc 字段，再通过框架支持的转换方式把它们写进数据库。
定义带自定义属性的枚举
每个枚举常量要携带业务需要的值（如状态码、中文名），用 private final 字段 + 私有构造方法 + public getter 封装：
- 字段必须声明为 private final，保证不可变和线程安全
- 构造方法必须是 private（编译器强制）
- 提供 getter 方法供外部读取，不暴露字段本身
示例：
public enum OrderStatus {PENDING("待处理", 0),
PROCESSING("处理中", 1),
COMPLETED("已完成", 2);
private final String desc;
private final int code;
OrderStatus(String desc, int code) {
this.desc = desc;
this.code = code;
}
public String getDesc() { return desc; }
public int getCode() { return code; }
}
JPA/Hibernate：用 AttributeConverter 实现自定义映射
当使用 JPA 或 Hibernate 时，@Enumerated 只支持 ORDINAL（序号）和 STRING（枚举名），无法映射到你定义的 code 或 desc。此时需实现 AttributeConverter<OrderStatus, Integer>：
立即学习“Java免费学习笔记（深入）”；
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- convertToDatabaseColumn：把枚举对象转成你要存的值（如
status.getCode()） - convertToEntityAttribute：把数据库读出的整数反查回枚举（建议用静态 Map 缓存，避免每次遍历
values()） - 在实体字段上加
@Convert(converter = OrderStatusConverter.class)
这样数据库字段就能存 0/1/2，而不是 "PENDING" 或 0/1/2（ORDINAL 的序号，和业务 code 撞车易出错）。
MyBatis-Plus：用 @EnumValue 注解自动识别编码字段
如果你用 MyBatis-Plus，更简单：在枚举的编码字段上加 @EnumValue，框架会自动识别并用于数据库读写：
- 给
code字段加上@EnumValue注解 - 确保实体类中对应字段类型是枚举，并开启枚举自动处理（默认开启）
- 查询时 status=1 → 自动匹配到
PROCESSING；插入时设entity.setStatus(OrderStatus.PROCESSING)→ 自动写入1
注意：@EnumValue 只认一个字段，如果同时想存描述文本，需额外配合 @TableField + 自定义 TypeHandler，或改用字符串列存 getDesc()。
通用建议：别依赖 ORDINAL，优先存自定义 code
用 EnumType.ORDINAL 风险高——一旦增删枚举常量，序号全乱，数据库数据就失效。而自定义 code 是业务语义明确、可长期稳定的标识：
- 数据库字段类型选 TINYINT/SMALLINT（存数字）或 VARCHAR（存描述）
- 枚举类内部用静态 Map 建立
code → 枚举实例的反查缓存，提升查找性能 - 所有对外暴露的转换逻辑，统一收口在枚举类自己的静态方法里（如
fromCode(int)），返回 Optional 更安全
