JPA/OpenJPA：将数据库整数字段映射至自定义对象而非枚举

JPA通用方案（推荐） #

JPA 2.1及以上提供了AttributeConverter接口，专门用于实现实体属性与数据库字段的双向转换，完全适配你的需求，且兼容所有支持JPA标准的ORM框架（包括OpenJPA）。

实现步骤： #

1. 定义自定义对象
   创建包含业务逻辑的自定义对象，示例如下：

   public class CustomType {
       private int code;
       private String label;
   
       // 根据业务逻辑实现构造器、getter/setter
       public CustomType(int code) {
           switch(code) {
               case 1: this.label = "类型A"; break;
               case 2: this.label = "类型B"; break;
               default: throw new IllegalArgumentException("无效code值: " + code);
           }
           this.code = code;
       }
   
       public int getCode() {
           return code;
       }
   }
   

2. 实现AttributeConverter转换器
   编写转换器类，处理双向转换逻辑：

   import javax.persistence.AttributeConverter;
   import javax.persistence.Converter;
   
   // autoApply=true表示全局生效，若仅需特定字段使用，设为false并在字段单独加@Convert
   @Converter(autoApply = false)
   public class CustomTypeConverter implements AttributeConverter<CustomType, Integer> {
   
       @Override
       public Integer convertToDatabaseColumn(CustomType attribute) {
           // 确保非空（对应数据库非空字段）
           if (attribute == null) {
               throw new IllegalArgumentException("自定义对象不能为空");
           }
           return attribute.getCode();
       }
   
       @Override
       public CustomType convertToEntityAttribute(Integer dbData) {
           // 确保非空（对应数据库非空字段）
           if (dbData == null) {
               throw new IllegalArgumentException("数据库字段值不能为空");
           }
           return new CustomType(dbData);
       }
   }
   

3. 在实体类字段上应用转换器
   替换原枚举字段为自定义对象类型，并通过@Convert指定转换器：

   import javax.persistence.Column;
   import javax.persistence.Convert;
   import javax.persistence.Entity;
   import javax.persistence.Id;
   
   @Entity
   public class YourEntity {
       @Id
       private Long id;
   
       @Column(nullable = false)
       @Convert(converter = CustomTypeConverter.class)
       private CustomType customField;
   
       // 其他字段、getter/setter
   }
   

OpenJPA专属方案 #

若需使用OpenJPA原生特性，可采用以下两种方式：

方式1：使用OpenJPA的@TypeConverter #

通过OpenJPA原生注解定义转换器，适配框架扩展特性：

import org.apache.openjpa.persistence.TypeConverter;

@TypeConverter(autoApply = false)
public class OpenJPACustomTypeConverter implements org.apache.openjpa.persistence.Converter<CustomType, Integer> {

   @Override
   public Integer toDataSourceValue(CustomType attribute, org.apache.openjpa.persistence.ConverterContext context) {
       if (attribute == null) {
           throw new IllegalArgumentException("自定义对象不能为空");
       }
       return attribute.getCode();
   }

   @Override
   public CustomType toAttributeValue(Integer dataSourceValue, org.apache.openjpa.persistence.ConverterContext context) {
       if (dataSourceValue == null) {
           throw new IllegalArgumentException("数据库字段值不能为空");
       }
       return new CustomType(dataSourceValue);
   }
}

在实体字段上通过@Persistent指定转换器：

import org.apache.openjpa.persistence.Persistent;

@Entity
public class YourEntity {
   // ...其他字段

   @Column(nullable = false)
   @Persistent(converter = OpenJPACustomTypeConverter.class)
   private CustomType customField;
}

方式2：全局注册转换器 #

若希望转换器全局生效，无需逐个字段标注，可在persistence.xml中添加配置：

<property name="openjpa.TypeConverter" value="com.yourpackage.OpenJPACustomTypeConverter"/>

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