實體管理器概述

實體管理器（EntityManager）用于管理系統(tǒng)中的實體，它是實體與數(shù)據(jù)庫之間的橋梁，通過調(diào)用實體管理器的相關(guān)方法可以把實體持久化到數(shù)據(jù)庫中，同時也可以把數(shù)據(jù)庫中的記錄打包成實體對象。

實體的四種狀態(tài)

在此之前我們要先了解實體的狀態(tài)及其轉(zhuǎn)換，見下圖

JPA 實體生命周期有四種狀態(tài)

• 新建狀態(tài)（New）：對象在保存進數(shù)據(jù)庫之前為臨時狀態(tài)。此時數(shù)據(jù)庫中沒有該對象的信息，該對象的ID屬性也為空。如果沒有被持久化，程序退出時臨時狀態(tài)的對象信息將丟失。
• 托管狀態(tài)（Managed）：對象在保存進數(shù)據(jù)庫后或者從數(shù)據(jù)庫中加載后、并且沒有脫離Session時為持久化狀態(tài)。這時候數(shù)據(jù)庫中有對象的信息，改對象的id為數(shù)據(jù)庫中對應(yīng)記錄的主鍵值。由于還在 Session中，持久化狀態(tài)的對象可以執(zhí)行任何有關(guān)數(shù)據(jù)庫的操作，例如獲取集合屬性的值等。
• 游離狀態(tài)（Datached）：是對象曾經(jīng)處于持久化狀態(tài)、但是現(xiàn)在已經(jīng)離開Session了。雖然分離狀態(tài)的對象有id值，有對應(yīng)的數(shù)據(jù)庫記錄，但是已經(jīng)無法執(zhí)行有關(guān)數(shù)據(jù)庫的操作。例如，讀取延遲加載的集合屬性，可能會拋出延遲加載異常。
• 刪除狀態(tài)（Removed）：刪除的對象，有id值，尚且和 Persistence  Context 有關(guān)聯(lián)，但是已經(jīng)準備好從數(shù)據(jù)庫中刪除。

創(chuàng)建實體管理器

所有實體管理器都來自類型?javax.persistence.EntityManagerFactory?的工廠。

以下示例演示為名為“EmployeeService”的持久性單元創(chuàng)建一個?EntityManagerFactory?：

EntityManagerFactory emf = 
    Persistence.createEntityManagerFactory("EmployeeService");

以下示例演示如何在上一個示例中獲取的工廠創(chuàng)建實體管理器：

EntityManager em = emf.createEntityManager();

保存實體

我們使用實體管理器來持久化?Employee?的實例。

Employee emp = new Employee(158);
em.persist(emp);

以下代碼顯示如何在創(chuàng)建新員工并將其保留到數(shù)據(jù)庫的方法中使用?EntityManager?。

public Employee createEmployee(int id, String name, long salary) {
    Employee emp = new Employee(id);
    emp.setName(name);
    emp.setSalary(salary);
    em.persist(emp);
    return emp;
}

查找實體

一旦實體在數(shù)據(jù)庫中，下一行代碼顯示如何找到它。

Employee emp = em.find(Employee.class, 1);

刪除實體

要從數(shù)據(jù)庫中刪除實體，請從?EntityManager?調(diào)用?remove?方法。

Employee emp = em.find(Employee.class, 1);
em.remove(emp);

更新實體

要更新實體，我們可以在被管實體上調(diào)用?setter?方法。被管實體是從?EntityManager?返回的實體。

Employee emp = em.find(Employee.class, 1);
emp.setName("new Name");

事務(wù)

以下代碼顯示如何啟動和提交事務(wù)。

em.getTransaction().begin(); Employee emp = new Employee(158); em.persist(emp); em.getTransaction().commit();

查詢

在?JPA?中，有一種稱為?Java?持久性查詢語言（JP QL）的新的查詢語言。

以下示例顯示如何創(chuàng)建動態(tài)查詢，然后執(zhí)行它以獲取數(shù)據(jù)庫中的所有員工。

TypedQuery<Employee> query = 
     em.createQuery("SELECT e FROM Employee e",
                     Employee.class);
List<Employee> emps = query.getResultList();

我們通過在?EntityManager?上發(fā)出?createQuery()?調(diào)用并傳入 JP QL 字符串來創(chuàng)建一個?TypedQuery<Employee>?對象。

JP QL 字符串不是指?EMPLOYEE?數(shù)據(jù)庫表，而是Employee實體。

例子

以下代碼顯示了一個簡單的完全功能類，可用于對?Employee?實體發(fā)出典型的創(chuàng)建，讀取，更新和刪除（CRUD）操作。

import java.util.List;

import javax.persistence.EntityManager;
import javax.persistence.TypedQuery;

public class EmployeeService {
  protected EntityManager em;

  public EmployeeService(EntityManager em) {
    this.em = em;
  }

  public Employee createEmployee(int id, String name, long salary) {
    Employee emp = new Employee(id);
    emp.setName(name);
    emp.setSalary(salary);
    em.persist(emp);
    return emp;
  }

  public void removeEmployee(int id) {
    Employee emp = findEmployee(id);
    if (emp != null) {
      em.remove(emp);
    }
  }

  public Employee raiseEmployeeSalary(int id, long raise) {
    Employee emp = em.find(Employee.class, id);
    if (emp != null) {
      emp.setSalary(emp.getSalary() + raise);
    }
    return emp;
  }

  public Employee findEmployee(int id) {
    return em.find(Employee.class, id);
  }

  public List<Employee> findAllEmployees() {
    TypedQuery<Employee> query = em.createQuery("SELECT e FROM Employee e",
        Employee.class);
    return query.getResultList();
  }
}

主類

import java.util.List;

import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.Persistence;

public class Main {

  public static void main(String[] args) {
    EntityManagerFactory emf = Persistence
        .createEntityManagerFactory("EmployeeService");
    EntityManager em = emf.createEntityManager();
    EmployeeService service = new EmployeeService(em);

    em.getTransaction().begin();
    Employee emp = service.createEmployee(1, "Tom", 5000);
    em.getTransaction().commit();
    System.out.println("Persisted " + emp);

    emp = service.findEmployee(1);
    System.out.println("Found " + emp);

    List<Employee> emps = service.findAllEmployees();
    for (Employee e : emps)
      System.out.println("Found employee: " + e);

    em.getTransaction().begin();
    emp = service.raiseEmployeeSalary(1, 1000);
    em.getTransaction().commit();
    System.out.println("Updated " + emp);

    em.getTransaction().begin();
    service.removeEmployee(158);
    em.getTransaction().commit();
    System.out.println("Removed Employee 158");

    em.close();
    emf.close();
  }
}

持久性單元

描述持久性單元的配置在名為 persistence.xml 的XML文件中定義。

每個持久性單元都被命名。單個 persistence.xml 文件可以包含一個或多個命名的持久性單元配置。

以下代碼顯示了 persistence.xml 文件的演示

<persistence>
   <persistence-unit name="EmployeeService" transaction-type="RESOURCE_LOCAL">
      <properties>
         <property name="javax.persistence.jdbc.driver" value="org.apache.derby.jdbc.ClientDriver"/>
         <property name="javax.persistence.jdbc.url" value="jdbc:derby://localhost:1527/EmpServDB;create=true"/>
         <property name="javax.persistence.jdbc.user" value="APP"/>
         <property name="javax.persistence.jdbc.password" value="APP"/>
      </properties>
   </persistence-unit>
</persistence>

persistence.xml 文件應(yīng)放在 META-INF 目錄中。