java枚举映射数据库字段需建立枚举值与存储值的双向对应，通过typehandler（mybatis）或attributeconverter（jpa）实现int/string↔枚举转换，避免使用ordinal，推荐自定义code并校验非法值。
Java 枚举类映射数据库字段，核心是建立枚举值与数据库存储值（如字符串或整数）之间的双向对应关系，并在 ORM 框架（如 MyBatis 或 JPA）中正确配置转换逻辑。
定义带数据库值的枚举
枚举类需显式持有可持久化的字段（如 code 或 value），并提供根据该字段查找枚举实例的静态方法。
例如，表示订单状态：
public enum OrderStatus {
PENDING(0, "待处理"),
CONFIRMED(1, "已确认"),
SHIPPED(2, "已发货"),
COMPLETED(3, "已完成");
private final int code;
private final String desc;
OrderStatus(int code, String desc) {
this.code = code;
this.desc = desc;
}
public int getCode() { return code; }
public String getDesc() { return desc; }
public static OrderStatus fromCode(int code) {
for (OrderStatus status : values()) {
if (status.code == code) {
return status;
}
}
throw new IllegalArgumentException("Unknown code: " + code);
}
}
MyBatis 中使用 TypeHandler 自定义转换
MyBatis 默认不识别自定义枚举与数据库字段的映射，需实现 TypeHandler 完成 int ↔ 枚举的转换。
示例：将 OrderStatus 映射为数据库中的 TINYINT 字段：
public class OrderStatusTypeHandler implements TypeHandler<orderstatus> {
@Override
public void setParameter(PreparedStatement ps, int i, OrderStatus parameter, JdbcType jdbcType)
throws SQLException {
ps.setInt(i, parameter != null ? parameter.getCode() : 0);
}
@Override
public OrderStatus getResult(ResultSet rs, String columnName) throws SQLException {
int code = rs.getInt(columnName);
return rs.wasNull() ? null : OrderStatus.fromCode(code);
}
@Override
public OrderStatus getResult(ResultSet rs, int columnIndex) throws SQLException {
int code = rs.getInt(columnIndex);
return rs.wasNull() ? null : OrderStatus.fromCode(code);
}
@Override
public OrderStatus getResult(CallableStatement cs, int columnIndex) throws SQLException {
int code = cs.getInt(columnIndex);
return cs.wasNull() ? null : OrderStatus.fromCode(code);
}
}</orderstatus>
然后在 MyBatis 的 XML 映射文件中指定：
<result column="status" property="status" typehandler="com.example.OrderStatusTypeHandler"></result>
或在注解方式中使用：
@Results({@Result(property = "status", column = "status",
typeHandler = OrderStatusTypeHandler.class)})
JPA/Hibernate 中用 @Enumerated 或 @Convert
若数据库存的是枚举名（如 "PENDING"），可用 @Enumerated(EnumType.STRING)；若存的是序号（0, 1, 2...），用 @Enumerated(EnumType.ORDINAL)。但推荐存自定义 code，更稳定。
此时应使用 @Convert 配合 AttributeConverter：
@Converter(autoApply = false)
public class OrderStatusConverter implements AttributeConverter<orderstatus integer> {
@Override
public Integer convertToDatabaseColumn(OrderStatus attribute) {
return attribute == null ? null : attribute.getCode();
}
@Override
public OrderStatus convertToEntityAttribute(Integer dbData) {
return dbData == null ? null : OrderStatus.fromCode(dbData);
}
}</orderstatus>
实体类中使用：
@Convert(converter = OrderStatusConverter.class) private OrderStatus status;
注意事项与建议
- 避免使用
EnumType.ORDINAL：枚举顺序变动会导致数据错乱 - 数据库字段类型要匹配：code 是 int 就用
INT/TINYINT，是 String 就用VARCHAR - 务必在
fromCode或fromValue方法中处理非法值，防止运行时异常 - MyBatis 的 TypeHandler 可全局注册，避免每个字段重复配置
- 考虑增加
isValidCode(int)工具方法，便于校验入参
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
