1.0jpa 2.0_JPA 2.1实体图–第1部分：命名实体图

1.0jpa 2.0

延迟加载通常是JPA 2.0的问题。如果要使用FetchType.LAZY（默认）或FetchType.EAGER来加载关系，则必须在实体上进行定义，并且始终使用此模式。仅当我们要始终加载关系时才使用FetchType.EAGER。在几乎所有情况下都使用FetchType.LAZY来获得性能良好且可伸缩的应用程序。

但这并非没有缺点。如果必须使用关系的元素，则需要确保在从数据库加载实体的事务中初始化该关系。这可以通过使用特定的查询来完成，该查询从数据库中读取实体和所需的关系。但这将导致用例特定的查询。另一个选择是在您的业务代码中访问该关系，这将导致对每个关系的附加查询。两种方法都不完美。

JPA 2.1实体图是一个更好的解决方案。实体图的定义与查询无关，并且定义了要从数据库中获取哪些属性。实体图可以用作访存图或负载图。如果使用提取图，则仅由实体图指定的属性将被视为FetchType.EAGER。所有其他属性将是惰性的。如果使用负载图，则实体图未指定的所有属性将保留其默认提取类型。

让我们看看如何定义和使用实体图。

示例实体

在此示例中，我们将使用带有项目列表的订单，每个项目都有一个产品。所有关系都是懒惰的。

订单实体：

@Entity
@Table(name = "purchaseOrder")
@NamedEntityGraph(name = "graph.Order.items", attributeNodes = @NamedAttributeNode(value = "items", subgraph = "items"), subgraphs = @NamedSubgraph(name = "items", attributeNodes = @NamedAttributeNode("product")))
public class Order implements Serializable {@Id@GeneratedValue(strategy = GenerationType.AUTO)@Column(name = "id", updatable = false, nullable = false)private Long id = null;@Version@Column(name = "version")private int version = 0;@Columnprivate String orderNumber;@OneToMany(mappedBy = "order", fetch = FetchType.LAZY)private Set<OrderItem> items = new HashSet<OrderItem>();...

OrderItem实体：

@Entity
public class OrderItem implements Serializable
{@Id@GeneratedValue(strategy = GenerationType.AUTO)@Column(name = "id", updatable = false, nullable = false)private Long id = null;@Version@Column(name = "version")private int version = 0;@Columnprivate int quantity;@ManyToOneprivate Order order;@ManyToOne(fetch = FetchType.LAZY)private Product product;

产品实体：

@Entity
public class Product implements Serializable
{@Id@GeneratedValue(strategy = GenerationType.AUTO)@Column(name = "id", updatable = false, nullable = false)private Long id = null;@Version@Column(name = "version")private int version = 0;@Columnprivate String name;

命名实体图

命名实体图的定义由实体上的@NamedEntityGraph批注完成。它定义了唯一的名称和已加载的属性列表（ attributeNodes ）。

以下示例显示了实体图“ graph.Order.items”的定义，该图将加载Order的OrderItem列表。

@Entity
@Table(name = "purchase_order")
@NamedEntityGraph(name = "graph.Order.items", attributeNodes = @NamedAttributeNode("items"))
public class Order implements Serializable {...

现在我们已经定义了实体图，我们可以在查询中使用它。因此，我们需要创建带有查询提示的Map，并将其设置为find或query方法调用上的附加参数。

以下代码段显示了如何在find语句中使用命名实体图作为获取图。

EntityGraph graph = this.em.getEntityGraph("graph.Order.items");Map hints = new HashMap();
hints.put("javax.persistence.fetchgraph", graph);return this.em.find(Order.class, orderId, hints);

命名子图

我们使用实体图来定义Order实体的提取操作。如果我们想对OrderItem实体执行相同的操作，则可以使用实体子图执行此操作。命名子图的定义类似于命名实体图的定义，并且可以引用为attributeNode。

以下代码段显示了用于加载每个OrderItem的Product的子图的定义。定义的实体图将获取包含所有OrderItem及其产品的Order 。

@Entity
@Table(name = "purchase_order")
@NamedEntityGraph(name = "graph.Order.items", attributeNodes = @NamedAttributeNode(value = "items", subgraph = "items"), subgraphs = @NamedSubgraph(name = "items", attributeNodes = @NamedAttributeNode("product")))
public class Order implements Serializable {

里面发生什么事了？

好的，从发展的角度来看，实体图很棒。它们易于使用，我们不需要编写其他代码来避免延迟加载问题。但是里面发生了什么？有多少查询发送到数据库？让我们看看Hibernate调试日志。

2014-03-22 21:56:08,285 DEBUG [org.hibernate.loader.plan.build.spi.LoadPlanTreePrinter] (pool-2-thread-1) LoadPlan(entity=blog.thoughts.on.java.jpa21.entity.graph.model.Order) - Returns - EntityReturnImpl(entity=blog.thoughts.on.java.jpa21.entity.graph.model.Order, querySpaceUid=<gen:0>, path=blog.thoughts.on.java.jpa21.entity.graph.model.Order) - CollectionAttributeFetchImpl(collection=blog.thoughts.on.java.jpa21.entity.graph.model.Order.items, querySpaceUid=<gen:1>, path=blog.thoughts.on.java.jpa21.entity.graph.model.Order.items) - (collection element) CollectionFetchableElementEntityGraph(entity=blog.thoughts.on.java.jpa21.entity.graph.model.OrderItem, querySpaceUid=<gen:2>, path=blog.thoughts.on.java.jpa21.entity.graph.model.Order.items.<elements>) - EntityAttributeFetchImpl(entity=blog.thoughts.on.java.jpa21.entity.graph.model.Product, querySpaceUid=<gen:3>, path=blog.thoughts.on.java.jpa21.entity.graph.model.Order.items.<elements>.product) - QuerySpaces - EntityQuerySpaceImpl(uid=<gen:0>, entity=blog.thoughts.on.java.jpa21.entity.graph.model.Order) - SQL table alias mapping - order0_ - alias suffix - 0_ - suffixed key columns - {id1_2_0_} - JOIN (JoinDefinedByMetadata(items)) : <gen:0> -> <gen:1> - CollectionQuerySpaceImpl(uid=<gen:1>, collection=blog.thoughts.on.java.jpa21.entity.graph.model.Order.items) - SQL table alias mapping - items1_ - alias suffix - 1_ - suffixed key columns - {order_id4_2_1_} - entity-element alias suffix - 2_ - 2_entity-element suffixed key columns - id1_0_2_ - JOIN (JoinDefinedByMetadata(elements)) : <gen:1> -> <gen:2> - EntityQuerySpaceImpl(uid=<gen:2>, entity=blog.thoughts.on.java.jpa21.entity.graph.model.OrderItem) - SQL table alias mapping - items1_ - alias suffix - 2_ - suffixed key columns - {id1_0_2_} - JOIN (JoinDefinedByMetadata(product)) : <gen:2> -> <gen:3> - EntityQuerySpaceImpl(uid=<gen:3>, entity=blog.thoughts.on.java.jpa21.entity.graph.model.Product) - SQL table alias mapping - product2_ - alias suffix - 3_ - suffixed key columns - {id1_1_3_} 2014-03-22 21:56:08,285 DEBUG [org.hibernate.loader.entity.plan.EntityLoader] (pool-2-thread-1) Static select for entity blog.thoughts.on.java.jpa21.entity.graph.model.Order [NONE:-1]: select order0_.id as id1_2_0_, order0_.orderNumber as orderNum2_2_0_, order0_.version as version3_2_0_, items1_.order_id as order_id4_2_1_, items1_.id as id1_0_1_, items1_.id as id1_0_2_, items1_.order_id as order_id4_0_2_, items1_.product_id as product_5_0_2_, items1_.quantity as quantity2_0_2_, items1_.version as version3_0_2_, product2_.id as id1_1_3_, product2_.name as name2_1_3_, product2_.version as version3_1_3_ from purchase_order order0_ left outer join OrderItem items1_ on order0_.id=items1_.order_id left outer join Product product2_ on items1_.product_id=product2_.id where order0_.id=?

日志显示仅创建了一个查询。 Hibernate使用实体图来创建具有所有3个实体（ Order ， OrderItem和Product ）的加载计划，并通过一个查询加载它们。