构建复杂查询是开发基于数据库的应用程序时常见的需求之一。对于使用 Hibernate 的开发者来说，Criteria API 提供了一种强大且灵活的方式来执行非平凡的查询操作。与传统的 HQL 或原生 SQL 查询相比，Criteria API 允许开发者以面向对象的方式构建查询逻辑，同时保持了 SQL 的表达能力。本文将探讨 Hibernate Criteria API 的基本用法，并通过具体示例展示如何利用它来解决实际问题。
Criteria API 是 Hibernate 3 引入的一个特性，它允许开发者通过 API 构建查询条件，而不是直接编写字符串形式的查询语句。这不仅提高了代码的可读性和可维护性，还增强了安全性，因为 Criteria API 会自动处理 SQL 注入等问题。首先，让我们看看如何使用 Criteria API 执行一个简单的查询。
import org.hibernate.Criteria;
import org.hibernate.Session;
import org.hibernate.criterion.Restrictions;
public class ProductManager {
public List<Product> findProductsByName(String name) {
Session session = HibernateUtil.getSessionFactory().openSession();
Criteria criteria = session.createCriteria(Product.class);
criteria.add(Restrictions.eq("name", name));
List<Product> products = criteria.list();
session.close();
return products;
}
}
上述代码展示了如何通过 createCriteria 方法来创建一个 Criteria 对象，并使用 Restrictions.eq 方法来添加一个等于条件。criteria.list() 用于执行查询并返回结果列表。这是一个非常基础的例子，但对于理解 Criteria API 的工作原理很有帮助。
当查询变得更为复杂时，Criteria API 的优势便显现出来。例如，假设我们需要查找所有价格在一定范围内的产品，并按照价格降序排列。这样的需求可以轻松通过 Criteria API 实现：
public List<Product> findProductsInRange(BigDecimal minPrice, BigDecimal maxPrice) {
Session session = HibernateUtil.getSessionFactory().openSession();
Criteria criteria = session.createCriteria(Product.class);
criteria.add(Restrictions.between("price", minPrice, maxPrice))
.addOrder(Order.desc("price"));
List<Product> products = criteria.list();
session.close();
return products;
}
在这里，Restrictions.between 用来添加一个价格范围的条件，而 addOrder 方法则用来指定排序规则。Criteria API 支持多种排序方式，包括升序（Order.asc）和降序（Order.desc）。
除了基本的查询条件，Criteria API 还支持更高级的功能，比如分页查询。这对于处理大量数据时尤为重要。下面是一个使用分页功能的例子：
public List<Product> findProductsPaginated(int pageSize, int pageNumber) {
Session session = HibernateUtil.getSessionFactory().openSession();
Criteria criteria = session.createCriteria(Product.class);
criteria.setFirstResult((pageNumber - 1) * pageSize);
criteria.setMaxResults(pageSize);
List<Product> products = criteria.list();
session.close();
return products;
}
在上述示例中，setFirstResult 方法用于设置起始位置，setMaxResults 方法用于设置每页显示的结果数量。这使得我们可以方便地实现分页功能。
除了上述的基础功能，Criteria API 还支持更复杂的查询构建，如连接查询、子查询等。例如，如果需要从多个表中联合查询数据，可以使用 createAlias 方法来添加连接条件：
public List<Product> findProductsByCategoryName(String categoryName) {
Session session = HibernateUtil.getSessionFactory().openSession();
Criteria criteria = session.createCriteria(Product.class, "product");
criteria.createAlias("product.category", "category");
criteria.add(Restrictions.eq("category.name", categoryName));
List<Product> products = criteria.list();
session.close();
return products;
}
这里 createAlias 方法用于创建一个别名，使得可以在后续的查询条件中引用 product.category，从而实现表的连接。
总之，Hibernate Criteria API 为开发者提供了一种强大的工具，能够以面向对象的方式构建复杂的查询。通过上述示例可以看到，无论是简单的条件过滤还是复杂的分页和连接查询，Criteria API 都能胜任。掌握这一工具，不仅能提升开发效率，还能增强应用程序的健壮性和扩展性。
