如何使用 Hibernate 映射 java.time.Year 和其他 java.time 类型

Question

hibernate-java8 JAR 为 Instant、LocalDate 等几个类提供适配器，但缺少来自 java.time 的一些类，例如 Year、Month、YearMonth .这些类被存储为未知的Serializable，这是不必要的浪费。

当然我可以使用int year 代替Year year，但我不认为这是个好主意。

看起来写YearJavaDescriptor 应该很容易，但是，我想知道为什么它不见了。特别是在YearMonth 的情况下，我更喜欢现有的适配器，有吗？ 还是我在做傻事？

我不确定谷歌搜索没有返回任何结果。

Answer 1

尝试为此创建一个转换器 - AttributeConverter 实现。

我过去使用过类似以下内容：

@Entity
public class RealEstateAgency {
    @Column(name = "createdAt")
    @Convert(converter = ZonedDateTimeConverter.class)
    private ZonedDateTime creationDate;
}

@Converter(autoApply = true)
public class ZonedDateTimeConverter implements AttributeConverter<ZonedDateTime, Date> {
 
    public Date convertToDatabaseColumn(ZonedDateTime toConvert) {
        return toConvert == null ? null : Date.from(toConvert.toInstant());
    }
 
    public ZonedDateTime convertToEntityAttribute(Date toConvert) {
        return toConvert == null ? null : ZonedDateTime.from(toConvert
                .toInstant());
    }
}

Answer 2

如果您的 JPA 提供者没有以合理的方式持久化一个类型（在这种情况下，因为它是一个 Java8 类，它是在 JPA 2.1 获得批准后添加的），那么您需要定义一个 JPA 2.1 AttributeConverter 来将其转换为标准 JPA 可持久类型（在本例中类似于 java.sql.Date）。

Answer 3

使用 JPA AttributeConverter

对于YearMonth，您可以像这样创建以下YearMonthDateAttributeConverter：

public class YearMonthDateAttributeConverter
        implements AttributeConverter<YearMonth, java.sql.Date> {
 
    @Override
    public java.sql.Date convertToDatabaseColumn(
            YearMonth attribute) {
        return java.sql.Date.valueOf(attribute.atDay(1));
    }
 
    @Override
    public YearMonth convertToEntityAttribute(
            java.sql.Date dbData) {
        return YearMonth
                .from(Instant.ofEpochMilli(dbData.getTime())
                .atZone(ZoneId.systemDefault())
                .toLocalDate());
    }
}

并且，在 YearMonth JPA 实体属性上使用 @Convert：

@Column(name = "published_on", columnDefinition = "date")
@Convert(converter = YearMonthDateAttributeConverter.class)
private YearMonth publishedOn;

使用 Hibernate 自定义类型

您可以通过扩展 AbstractSingleColumnStandardBasicType 来创建自定义 Hibernate 类型：

public class YearMonthDateType
        extends AbstractSingleColumnStandardBasicType<YearMonth> {
 
    public static final YearMonthDateType INSTANCE = 
        new YearMonthDateType();
 
    public YearMonthDateType() {
        super(
            DateTypeDescriptor.INSTANCE,
            YearMonthTypeDescriptor.INSTANCE
        );
    }
 
    public String getName() {
        return "yearmonth-date";
    }
 
    @Override
    protected boolean registerUnderJavaType() {
        return true;
    }
}

并定义YearMonthTypeDescriptor如下：

public class YearMonthTypeDescriptor
        extends AbstractTypeDescriptor<YearMonth> {
 
    public static final YearMonthTypeDescriptor INSTANCE = 
        new YearMonthTypeDescriptor();
 
    public YearMonthTypeDescriptor() {
        super(YearMonth.class);
    }
 
    @Override
    public boolean areEqual(
            YearMonth one, 
            YearMonth another) {
        return Objects.equals(one, another);
    }
 
    @Override
    public String toString(
            YearMonth value) {
        return value.toString();
    }
 
    @Override
    public YearMonth fromString(
            String string) {
        return YearMonth.parse(string);
    }
 
    @SuppressWarnings({"unchecked"})
    @Override
    public <X> X unwrap(
            YearMonth value, 
            Class<X> type, 
            WrapperOptions options) {
        if (value == null) {
            return null;
        }
        if (String.class.isAssignableFrom(type)) {
            return (X) toString(value);
        }
        if (Date.class.isAssignableFrom(type)) {
            return (X) java.sql.Date.valueOf(value.atDay(1));
        }
        throw unknownUnwrap(type);
    }
 
    @Override
    public <X> YearMonth wrap(
            X value, 
            WrapperOptions options) {
        if (value == null) {
            return null;
        }
        if (value instanceof String) {
            return fromString((String) value);
        }
        if (value instanceof Date) {
            Date date = (Date) value;
            return YearMonth
                .from(Instant.ofEpochMilli(date.getTime())
                .atZone(ZoneId.systemDefault())
                .toLocalDate());
        }
        throw unknownWrap(value.getClass());
    }
}

你不需要自己写这个类型，你可以使用Hibernate Types然后像这样声明Maven依赖：

<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-52</artifactId>
    <version>${hibernate-types.version}</version>
</dependency>

就是这样！