如何通过JPA在Oracle数据库将同一实体的枚举分存为整数与字符串

要实现同一个枚举类型在不同字段中分别以整数和字符串存储，核心是创建两个独立的属性转换器，并在实体字段上分别指定使用对应的转换器即可，具体步骤如下：

1. 修正枚举类（语法规范） #

enum MyEnum {
    ONE,
    TWO;
}

2. 创建整数类型转换器 #

这个转换器负责将枚举转换为整数（对应数据库的Some_Value字段）：

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

@Converter(autoApply = false) // 必须关闭自动应用，避免全局生效
public class MyEnumToIntegerConverter implements AttributeConverter<MyEnum, Integer> {

    @Override
    public Integer convertToDatabaseColumn(MyEnum attribute) {
        if (attribute == null) {
            return null;
        }
        // 示例中存储的是1、2，所以ordinal()+1（默认ordinal从0开始）
        return attribute.ordinal() + 1;
    }

    @Override
    public MyEnum convertToEntityAttribute(Integer dbData) {
        if (dbData == null) {
            return null;
        }
        return MyEnum.values()[dbData - 1];
    }
}

3. 创建字符串类型转换器 #

这个转换器负责将枚举转换为指定格式的字符串（对应数据库的Some_Value_Freezed字段）：

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

@Converter(autoApply = false) // 关闭自动应用，仅在指定字段生效
public class MyEnumToStringConverter implements AttributeConverter<MyEnum, String> {

    @Override
    public String convertToDatabaseColumn(MyEnum attribute) {
        if (attribute == null) {
            return null;
        }
        // 转换为首字母大写、其余小写的格式（匹配示例中的One、Two）
        String enumName = attribute.name();
        return enumName.substring(0, 1).toUpperCase() + enumName.substring(1).toLowerCase();
    }

    @Override
    public MyEnum convertToEntityAttribute(String dbData) {
        if (dbData == null) {
            return null;
        }
        // 将数据库字符串转为枚举（忽略大小写，匹配ONE/TWO）
        return MyEnum.valueOf(dbData.toUpperCase());
    }
}

4. 修改实体类，指定字段对应的转换器 #

在MyEntity的两个枚举字段上，分别用@Convert注解指定对应的转换器：

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Convert;

@Entity
class MyEntity {
    @Id
    int id;
    String name;

    // 指定用整数转换器
    @Convert(converter = MyEnumToIntegerConverter.class)
    MyEnum someValue;

    // 指定用字符串转换器
    @Convert(converter = MyEnumToStringConverter.class)
    MyEnum someValueFreezed;
}

关键注意事项 #

• 两个转换器必须设置autoApply = false：如果开启自动应用，JPA会把该转换器应用到所有MyEnum类型的字段，无法实现差异化存储。
• 整数转换的ordinal处理：如果你的业务需要从0开始存储，直接返回attribute.ordinal()即可，无需+1。
• 字符串格式匹配：根据数据库实际存储的字符串格式调整转换器的转换逻辑，确保双向转换一致。

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