java - JPA EntityGraph 如何允许在运行时选择实体图？

Question

我看过各种帖子，描述 JPA EntityGraph 允许在运行时选择图表。我不太清楚这指的是什么。

出于善意和尊重，我想引用这篇有用的文章:https://www.baeldung.com/jpa-entity-graph 。 (大多数 JPA 用户可能已经经历过它。)

文章引用 -

EntityGraph allows grouping the related persistence fields which wewant to retrieve and lets us choose the graph type at runtime.

并在结论部分再次巩固了上述陈述。

In this article, we've explored using the JPA Entity Graph todynamically fetch an Entity and its associations.

The decision is made at runtime in which we choose to load or not therelated association.

正如我们在文章 (5.1) 中看到的 - EntityGraph 使用注释定义如下 -
5.1。使用注释定义实体图

@NamedEntityGraph(
  name = "post-entity-graph",
  attributeNodes = {
    @NamedAttributeNode("subject"),
    @NamedAttributeNode("user"),
    @NamedAttributeNode("comments"),
  }
)
@Entity
public class Post {

    @OneToMany(mappedBy = "post")
    private List<Comment> comments = new ArrayList<>();
    
    //...
}

@NameEntityGraph 注释是在编译时定义的，我在这里没有看到任何运行时或动态的内容。

但在 5.2 中 - 实体图是使用 API 或以编程方式定义的 -
5.2。使用 JPA API 定义实体图

 EntityGraph<Post> entityGraph = entityManager.createEntityGraph(Post.class);
 entityGraph.addAttributeNodes("subject");
 entityGraph.addAttributeNodes("user");

在 5.2 方法中，我看到可以使用某种逻辑动态选择节点。这种方法就是所谓的“动态获取”和“基于运行时”。或者我错过了什么，我还有更多需要理解的吗？

进一步采用6 中给出的方法。使用实体图
例如:

EntityGraph entityGraph = entityManager.getEntityGraph("post-entity-graph");
Map<String, Object> properties = new HashMap<>();
properties.put("javax.persistence.fetchgraph", entityGraph);
Post post = entityManager.find(Post.class, id, properties);

都是编程性的，因此可以在运行时更改，即它们可以说是动态的。
但是上面的文章中遗漏了一种方法，但在这里提到了 - https://www.baeldung.com/spring-data-jpa-named-entity-graphs如下所示，似乎不符合动态标准。

public interface ItemRepository extends JpaRepository<Item, Long> {

    @EntityGraph(value = "Item.characteristics")
    Item findByName(String name);
}

动态方法是否仅指 5.2 风格，或者甚至也暗示 5.1 风格。

Answer 1

您不能将动态实体图与 spring-data 一起使用，因为 JpaRepository 没有方法来传递实体图，例如

Optional<T> findById(ID id, EntityGraph entityGraph);

使用自定义 JPA 存储库

您可以通过创建自定义存储库并通过 EntityManager 使用实体图来使用原始 JPA。

使用 spring-data-jpa-entity-graph

使用库 spring-data-jpa-entity-graph 有一种更方便的方法.

它允许将 findById() 或 findByName() 等 JPA 存储库方法与动态实体图一起使用。

我更喜欢将它与这个辅助类一起使用

public abstract class EntityGraphBuilder<T> {

    private List<String> result = new ArrayList<>();

    protected T self;

    public T add(String path) {
        result.add(path);
        return self;
    }

    public DynamicEntityGraph build() {
        return new DynamicEntityGraph(EntityGraphType.FETCH, result);
    }

}

每个实体都有自己的GraphBuilder

@Entity
public class OrderEntity {

    @Id
    private Long id;

    @Column
    private name;

    @ManyToOne(fetch = FetchType.LAZY)
    private OrderRequestEntity orderRequest;

    @ManyToOne(fetch = FetchType.LAZY)
    private ProviderEntity provider;

    public static GraphBuilder graph() {
        return new GraphBuilder();
    }

    public static class GraphBuilder extends EntityGraphBuilder<GraphBuilder> {

        private GraphBuilder() {
            self = this;
        }

        public GraphBuilder orderRequest() {
            return add("orderRequest");
        }

        public GraphBuilder provider() {
            return add("provider");
        }

    }

}

存储库使用 spring-data-jpa-entity-graph 库中的 EntityGraphJpaRepository

@Repository
public interface OrdersRepository extends EntityGraphJpaRepository<OrderEntity, Long> {

  OrderEntity findByName(String name, EntityGraph entityGraph);

}

您也可以将 findByName() 等派生查询方法与动态实体图结合使用。

使用findById()方法的示例，相同的方法可以应用于findByName()

OrdersRepository ordersRepository;
Long orderId = 1L;

OrderEntity order = ordersRepository.findById(
  orderId,
  OrderEntity.graph().orderRequest().provider().build()
).orElseThrow(
  () -> new ServiceException("Can't find orderId=" + orderId)
);