Hibernate 5.6中已弃用的@Type注解的替代方案是什么？

核心原则 #

优先使用JPA标准@Convert注解替代原@Type注解，该方案同时兼容Hibernate 5.6与Hibernate 6版本，迁移成本最低。

针对NumericBooleanType场景的替换方案 #

原使用@Type的代码如下：

@Type(type = "org.hibernate.type.NumericBooleanType")
private Boolean debug = false;

可选择以下两种替换方式：

• 方式1：使用Hibernate 5.6内置对应转换器

  // 若项目使用Java EE规范，将jakarta替换为javax即可
  import jakarta.persistence.Convert;
  import org.hibernate.type.NumericBooleanConverter;
  
  @Convert(converter = NumericBooleanConverter.class)
  private Boolean debug = false;
  

• 方式2：自定义通用转换器（完全不依赖Hibernate专有实现，适配所有JPA框架）
  首先定义转换器类：

  import jakarta.persistence.AttributeConverter;
  import jakarta.persistence.Converter;
  
  @Converter(autoApply = false)
  public class NumericBooleanConverter implements AttributeConverter<Boolean, Integer> {
      @Override
      public Integer convertToDatabaseColumn(Boolean attribute) {
          return Boolean.TRUE.equals(attribute) ? 1 : 0;
      }
  
      @Override
      public Boolean convertToEntityAttribute(Integer dbData) {
          return dbData != null && dbData == 1;
      }
  }
  

  字段上引用转换器：

  @Convert(converter = NumericBooleanConverter.class)
  private Boolean debug = false;
  

其他类型场景的通用处理逻辑 #

• 若使用Hibernate内置的其他类型，优先查找Hibernate 5.6中对应提供的AttributeConverter实现类，直接通过@Convert引用即可
• 若为自定义的专有类型，将原来的Type实现改造为实现JPAAttributeConverter接口，后续迁移到Hibernate 6无需额外调整

临时过渡方案 #

如果暂时没有时间批量改造代码，Hibernate 5.6版本中废弃的@Type注解仍可正常使用，功能不受影响，但Hibernate 6版本会彻底移除该注解，建议在版本迭代过程中逐步替换为@Convert方案。

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