//编辑:我更新了答案以反映JPA 2.1版和2.2版之间的差异。
JPA v2.1不知道Java 8类型,并将尝试对提供的值进行字符串化。对于LocalDateTime,Instant和OffsetDateTime,它将使用toString()方法并将相应的字符串保存到目标字段。
也就是说,您必须告诉JPA如何将您的值转换为相应的数据库类型,例如java.sql.Date
或java.sql.Timestamp
。
实施并注册AttributeConverter
界面以使其工作。
看到:
当心亚当·比恩(Adam Bien)的错误实现:必须首先对LocalDate进行分区。
您可以在此处的规范中看到这一点:JPA 2.2 spec。滚动到最后一页以查看时间类型。
如果使用jpql表达式,请确保使用Instant对象,并在PDO类中也使用Instant。
例如
// query does not make any sense, probably.
query.setParameter("createdOnBefore", Instant.Now());
这样很好。
无论如何,即使您具有zoneddatetime或OffsetDateTime,从数据库读取的结果也将始终为UTC,因为数据库存储的是即时时间,而与时区无关。 。
因此,我建议改为使用Instant
它,并且仅在需要时将其转换为“区域”或“偏移时间”类。要恢复给定区域或偏移量的时间,请将区域或偏移量分别存储在其自己的数据库字段中。
JPQL比较将与此解决方案一起使用,只需始终保持即时操作即可。
PS:我最近与一些Spring员工进行了交谈,他们还同意,除了Instant之外,您再也不会坚持任何其他方法。只有一个瞬间是特定的时间点,然后可以使用元数据进行转换。
根据JPA 2.2规范,未提及CompositeValues。这意味着,他们没有将其纳入规范中,并且此时您不能将单个字段持久保存到多个数据库列中。搜索“复合”,仅看到与ID相关的提及。
但是,正如此答案的注释中所述,Hibernate可能能够做到这一点。
我创建此示例时牢记以下原则:为扩展而打开,为修改而关闭。在此处阅读有关此原则的更多信息:Wikipedia上的开放/封闭原则。
这意味着,您可以将当前字段保留在数据库中(时间戳记),并且只需要添加其他列即可,这不会有任何问题。
另外,您的实体可以保留OffsetDateTime的设置方法和获取方法。内部结构应该与调用者无关。这意味着,此建议完全不会损害您的api。
一个实现可能看起来像这样:
@Entity
public class UserPdo {
@Column(name = "created_on")
private Instant createdOn;
@Column(name = "display_offset")
private int offset;
public void setCreatedOn(final Instant newInstant) {
this.createdOn = newInstant;
this.offset = 0;
}
public void setCreatedOn(final OffsetDateTime dt) {
this.createdOn = dt.toInstant();
this.offset = dt.getOffset().getTotalSeconds();
}
// derived display value
public OffsetDateTime getCreatedOnOnOffset() {
ZoneOffset zoneOffset = ZoneOffset.ofTotalSeconds(this.offset);
return this.createdOn.atOffset(zoneOffset);
}
}