在Java後端開發中，查詢資料是一個非常常見的操作，而使用JPA（Java Persistence API）是一個非常流行的方法。 JPA提供了一種靈活、可重複使用的方式來檢索和操作資料庫中的資料。然而，對於動態查詢（即查詢需要根據不同的參數進行調整）來說，使用傳統的靜態查詢語句或JPQL（Java Persistence Query Language）可能不太方便。在這種情況下，使用JPA Criteria API可以更加便利和靈活。
JPA Criteria API是一種物件導向的查詢方式，透過程式碼組裝查詢條件和傳回結果來實現。與傳統的靜態查詢語句或JPQL相比，它的一個主要優點是可以在查詢過程中動態拼接不同的查詢條件，並且能夠更好地應對資料模型的變化。本文將介紹如何使用JPA Criteria API來進行動態查詢。
首先，我們需要有一個實體類，假設我們有一個User實體類，它擁有id、name、age、gender等欄位。在使用JPA Criteria API之前，我們需要先定義這個實體類別。
@Entity @Table(name = "user") public class User { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String name; private Integer age; private Boolean gender; // 省略getter和setter方法 }
在使用JPA Criteria API之前，我們需要先取得CriteriaBuilder。 CriteriaBuilder是一個工廠類，用於創建各種CriteriaQuery、Predicate和Expression。通常，我們可以透過EntityManager來取得CriteriaBuilder。
@PersistenceContext private EntityManager entityManager; public ListgetUsers() { CriteriaBuilder cb = entityManager.getCriteriaBuilder(); // ... 继续后续操作 }
CriteriaQuery用於查詢操作，我們可以使用它來設定查詢的條件和傳回結果的類型。在設定查詢條件時，我們可以透過Predicate來設定多個限制條件，Predicate是Criteria API中用來建立查詢條件的小工具。
public ListgetUsers(String name, Integer age, Boolean gender) { CriteriaBuilder cb = entityManager.getCriteriaBuilder(); CriteriaQuery cq = cb.createQuery(User.class); Root root = cq.from(User.class); List predicates = new ArrayList<>(); if (name != null) { Predicate namePredicate = cb.equal(root.get("name"), name); predicates.add(namePredicate); } if (age != null) { Predicate agePredicate = cb.greaterThanOrEqualTo(root.get("age"), age); predicates.add(agePredicate); } if (gender != null) { Predicate genderPredicate = cb.equal(root.get("gender"), gender); predicates.add(genderPredicate); } cq.where(predicates.toArray(new Predicate[0])); return entityManager.createQuery(cq).getResultList(); }
上面的程式碼示範如何使用CriteriaBuilder來建立CriteriaQuery。首先，我們使用EntityManager取得CriteriaBuilder。然後，我們建立一個查詢物件CriteriaQuery
Expression是Criteria API中另一個很有用的概念，它表示一個運算表達式，可以被用來計算和比較一些複雜的資料類型。在使用Expression時，我們可以在原來的查詢條件下進行更精細的篩選。例如，我們可以使用between方法來查詢age在某個區間內的使用者。
public ListgetUsersInRange(Integer minAge, Integer maxAge) { CriteriaBuilder cb = entityManager.getCriteriaBuilder(); CriteriaQuery cq = cb.createQuery(User.class); Root root = cq.from(User.class); Expression ageExpression = root.get("age"); Predicate agePredicate = cb.between(ageExpression, minAge, maxAge); cq.where(agePredicate); return entityManager.createQuery(cq).getResultList(); }
上述程式碼查詢了年齡在minAge和maxAge之間的使用者。要注意的是，這裡我們使用了Expression
在某些場景下，我們需要對多個表進行查詢。此時我們需要使用Join，Join是多表格查詢的核心概念。假設我們有一個Task實體類，它擁有id和userId兩個字段，userId與User實體類別中的id字段關聯。
@Entity @Table(name = "task") public class Task { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private Long userId; // 省略getter和setter方法 }
我們可以透過Join將兩個實體類別關聯起來，查詢指定User下的所有Task。
