如何正确更新包含SortedSet集合的JPA实体？

一、SortedSet子实体集合更新时主键重复问题解决 #

核心原因 #

1. SortedSet依赖实体的equals/hashCode实现，若基于数据库主键（未生成的新实体主键为null）判断，会导致Hibernate误判新子实体为同一实例，重复插入关联表记录。
2. 双向关联未正确维护：添加子实体时未同步设置子实体的父实体引用，导致Hibernate无法识别关联关系的正确性。
3. 操作了detached状态的父实体：直接对离线实体进行修改后merge，易引发关联表数据重复插入。

解决方案 #

1. 修正子实体的equals/hashCode实现：基于业务唯一标识（而非数据库主键）编写，避免新实体因主键null被误判为同一对象：

@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    EntityTestChild that = (EntityTestChild) o;
    return Objects.equals(businessUniqueField, that.businessUniqueField); // 替换为你的业务唯一字段
}

@Override
public int hashCode() {
    return Objects.hash(businessUniqueField);
}

2. 规范关联映射配置：
   • 父实体（EntityTest）的一对多关联：

     @OneToMany(mappedBy = "parent", cascade = CascadeType.ALL, orphanRemoval = true)
     @SortComparator(EntityTestChildComparator.class) // 或用@OrderBy指定排序字段
     private SortedSet<EntityTestChild> children = new TreeSet<>();
     

   • 子实体（EntityTestChild）的多对一关联：

     @ManyToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "parent_id", nullable = false)
     private EntityTest parent;
     

   • 维护双向关联一致性：添加子实体时必须同步设置父实体引用：

     public void addChild(EntityTestChild child) {
         child.setParent(this);
         this.children.add(child);
     }
     

3. 正确的更新流程：
   • 在事务中操作持久化状态的父实体：先通过em.find(EntityTest.class, id)获取数据库中的父实体，再调用addChild方法添加子实体，无需手动merge（持久化状态的实体会自动被Hibernate同步到数据库）。

二、ApplicationScoped数据服务的合理性判断 #

ApplicationScoped数据服务可以使用，但必须严格保证线程安全：

• 禁止在ApplicationScoped bean中持有EntityManager实例（EntityManager是非线程安全的），每次数据库操作都应获取新的EntityManager，或使用容器管理的EntityManager（通过@PersistenceContext注入，容器会为每个请求/线程分配独立实例）。
• 若为Java EE环境，更推荐使用@Stateless EJB作为数据服务，容器会自动处理线程安全与事务管理；若坚持使用ApplicationScoped，需按需创建EntityManager：

@ApplicationScoped
public class DataService {
    @PersistenceUnit
    private EntityManagerFactory emf;

    public void updateEntityTest(Long id, EntityTestChild child) {
        try (EntityManager em = emf.createEntityManager()) {
            em.getTransaction().begin();
            EntityTest parent = em.find(EntityTest.class, id);
            parent.addChild(child);
            em.getTransaction().commit();
        }
    }
}

• 注意：ApplicationScoped bean的生命周期覆盖整个应用，禁止存储请求相关的状态数据，否则会引发线程安全问题。

三、EMF与UTX的生命周期最佳实践 #

1. EntityManagerFactory（EMF）：
   EMF是线程安全的，且创建开销极大，因此必须为应用级生命周期（ApplicationScoped），整个应用仅需一个EMF实例。Java EE环境中由容器自动管理EMF的创建与销毁；Java SE环境中需在应用启动时初始化，关闭时销毁。
2. UserTransaction（UTX）：
   • Java EE环境中不建议手动管理UTX，应使用容器管理事务（如EJB的@Transactional注解、CDI事务扩展），容器会自动处理事务的开启、提交与回滚。
   • Java SE环境中，UTX无需保持应用级实例，可按需从JNDI或TransactionManager获取，因UTX与当前线程绑定，用完即可释放。

内容的提问来源于stack exchange，提问作者Leandro Alsina