当我在实现乐观锁定后将瞬态对象作为查询参数传递时，Hibernate 抛出 TransientObjectException

Question

我在一个使用 Hibernate Entity Manager 的项目中工作，一切都很好，直到我开始在我们的实体中实现乐观锁。

例如，我们有以下命名查询 returns 一个人的地址：

@NamedQuery(name = "Address.findByPerson", query = "SELECT a FROM Address a WHERE a.person = :person")

为了将人物对象传递给这个查询，我们通常会这样做：

Person nPerson = new Person();
nPerson.setId(1);

TypedQuery<Address> query = manager.createNamedQuery("Address.findByPerson", Address.class);
query.setParameter("person", nPerson);
query.getResultList();

直到我们在 Person 实体中引入 @Version 之前都很好。之后，开始出现以下异常：

java.lang.reflect.InvocationTargetException
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:497)
    at com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(LauncherImpl.java:389)
    at com.sun.javafx.application.LauncherImpl.launchApplication(LauncherImpl.java:328)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:497)
    at sun.launcher.LauncherHelper$FXHelper.main(LauncherHelper.java:767)
Caused by: java.lang.IllegalStateException: org.hibernate.TransientObjectException: object references an unsaved transient instance - save the transient instance before flushing: com.sandboxmaven.entity.Person
    at org.hibernate.jpa.spi.AbstractEntityManagerImpl.convert(AbstractEntityManagerImpl.java:1760)
    at org.hibernate.jpa.spi.AbstractEntityManagerImpl.convert(AbstractEntityManagerImpl.java:1677)
    at org.hibernate.jpa.internal.QueryImpl.getResultList(QueryImpl.java:458)
    at com.sandboxmaven.main.Sandbox.main(Sandbox.java:52)
    ... 11 more
Caused by: org.hibernate.TransientObjectException: object references an unsaved transient instance - save the transient instance before flushing: com.sandboxmaven.entity.Person
    at org.hibernate.engine.internal.ForeignKeys.getEntityIdentifierIfNotUnsaved(ForeignKeys.java:294)
    at org.hibernate.type.EntityType.getIdentifier(EntityType.java:510)
    at org.hibernate.type.ManyToOneType.nullSafeSet(ManyToOneType.java:174)
    at org.hibernate.param.NamedParameterSpecification.bind(NamedParameterSpecification.java:67)
    at org.hibernate.loader.hql.QueryLoader.bindParameterValues(QueryLoader.java:613)
    at org.hibernate.loader.Loader.prepareQueryStatement(Loader.java:1900)
    at org.hibernate.loader.Loader.executeQueryStatement(Loader.java:1861)
    at org.hibernate.loader.Loader.executeQueryStatement(Loader.java:1838)
    at org.hibernate.loader.Loader.doQuery(Loader.java:909)
    at org.hibernate.loader.Loader.doQueryAndInitializeNonLazyCollections(Loader.java:354)
    at org.hibernate.loader.Loader.doList(Loader.java:2551)
    at org.hibernate.loader.Loader.doList(Loader.java:2537)
    at org.hibernate.loader.Loader.listIgnoreQueryCache(Loader.java:2367)
    at org.hibernate.loader.Loader.list(Loader.java:2362)
    at org.hibernate.loader.hql.QueryLoader.list(QueryLoader.java:496)
    at org.hibernate.hql.internal.ast.QueryTranslatorImpl.list(QueryTranslatorImpl.java:387)
    at org.hibernate.engine.query.spi.HQLQueryPlan.performList(HQLQueryPlan.java:229)
    at org.hibernate.internal.SessionImpl.list(SessionImpl.java:1260)
    at org.hibernate.internal.QueryImpl.list(QueryImpl.java:103)
    at org.hibernate.jpa.internal.QueryImpl.list(QueryImpl.java:573)
    at org.hibernate.jpa.internal.QueryImpl.getResultList(QueryImpl.java:449)
    ... 12 more

我无法在文档中找到有关此行为的任何解释。当然，解决仅传递 Person 或托管实体的 id 作为参数是一件简单的事情。但我想了解为什么会出现这种情况。有人知道为什么吗？

谢谢！

Answer 1

Hibernate 需要验证对象不是瞬态的，否则在查询中使用它没有意义。

Hibernate 如何检查一个对象是否是瞬态的？我找不到关于此的一些官方文档，但我查看了源代码。部分方法 AbstractEntityPersister.isTransient 如下所示：

// check the version unsaved-value, if appropriate
final Object version = getVersion( entity );
if ( isVersioned() ) {
    // let this take precedence if defined, since it works for
    // assigned identifiers
    Boolean result = entityMetamodel.getVersionProperty()
            .getUnsavedValue().isUnsaved( version );
    if ( result != null ) {
        return result;
    }
}

如您所见，Hibernate 将检查 version 字段的值（以及其他内容）以尝试验证对象是否是瞬态的。

由于原型 Person 中的 version 是 null （或其他未保存的值，基于确定未保存的值是什么的策略），Hibernate 知道实例是transient 并抛出异常。如果没有版本控制，Hibernate 会检查 person id 是否为 null（或其他未保存的值，基于策略）以区分瞬态和非瞬态实例：

// check the id unsaved-value
Boolean result = entityMetamodel.getIdentifierProperty()
        .getUnsavedValue().isUnsaved( id );
if ( result != null ) {
    return result;
}

所以它在你引入版本控制之前就起作用了，因为 id 不是 null。

要克服这个问题，最好按照您已经建议的那样将 id 传递给查询。或者您可以将 version 设置为您在查询中使用的 nPerson 原型：

Person nPerson = new Person();
nPerson.setId(1);
nPerson.setVersion(1);

这里我们可以设置任意版本值，因为反正用不到； Hibernate 会发现它不是 null 并且不会将该对象视为瞬态对象。

当我在实现乐观锁定后将瞬态对象作为查询参数传递时，Hibernate 抛出 TransientObjectException

Hibernate throw TransientObjectException when I pass a transient object as parameter for a query after I implement the optimist locking

java

hibernate

optimistic-locking