Java 10与JPA2中如何将枚举值映射到@Enumerated列？

要让JPA将枚举的自定义值（如"value 1"）而非枚举名称存入数据库，需要通过JPA的AttributeConverter接口实现自定义转换逻辑，具体步骤如下：

1. 完善枚举类，补充值获取与反向查找逻辑 #

先给MyEnum添加获取自定义值的方法，以及根据值反向匹配枚举实例的静态方法，为转换提供基础：

public enum MyEnum {
    NAME1("value 1"),
    NAME2("value 2");

    private final String value;

    MyEnum(String value) {
        this.value = value;
    }

    // 获取枚举对应的自定义值
    public String getValue() {
        return value;
    }

    // 根据自定义值反向查找枚举实例
    public static MyEnum fromValue(String value) {
        for (MyEnum enumInstance : MyEnum.values()) {
            if (enumInstance.value.equals(value)) {
                return enumInstance;
            }
        }
        throw new IllegalArgumentException("无效的枚举值: " + value);
    }
}

2. 实现AttributeConverter转换器 #

创建转换器类，定义枚举与数据库字符串之间的双向转换规则：

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;

// autoApply=true 会让JPA自动将该转换器应用到所有MyEnum类型的字段
@Converter(autoApply = true)
public class MyEnumConverter implements AttributeConverter<MyEnum, String> {

    @Override
    public String convertToDatabaseColumn(MyEnum attribute) {
        // 将枚举转换为数据库存储的自定义值
        return attribute != null ? attribute.getValue() : null;
    }

    @Override
    public MyEnum convertToEntityAttribute(String dbData) {
        // 将数据库中的值转换回枚举实例
        return dbData != null ? MyEnum.fromValue(dbData) : null;
    }
}

3. 调整实体类字段注解 #

移除原来的@Enumerated注解，因为自定义转换器会处理映射逻辑：

// 若转换器设置了autoApply=true，无需额外注解
private MyEnum status;

如果未设置autoApply=true，则需要在字段上显式指定转换器：

@Convert(converter = MyEnumConverter.class)
private MyEnum status;

注意事项 #

• 需手动更新数据库已有数据：原存储的枚举名称（如"NAME1"）要替换为对应的自定义值（如"value 1"），否则查询时会触发转换异常。
• 确保fromValue方法能覆盖数据库中所有可能存在的值，避免转换失败。

内容的提问来源于stack exchange，提问作者Dave