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

Question

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

例如，我们有以下命名查询返回一个人的地址:

@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 需要验证对象不是 transient 的，否则在查询中使用它没有意义。

Hibernate 如何检查一个对象是否是 transient 的？我找不到关于此的一些官方文档，但我查看了源代码。部分方法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 字段的值(以及其他内容)以尝试验证对象是否是 transient 的。

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

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

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

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

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

在这里我们可以设置任何版本值，因为它无论如何都不会被使用； Hibernate 将看到它不是 null 并且不会将该对象视为 transient 对象。