将JPA Specification与分页结合的最佳实践

class EmployeeEntity {
  private Long id;
  private EmployeeType type; // 假设 EmployeeType 是一个独立的实体
  private String name;

  // Getters and Setters
}

// 假设 EmployeeType 实体定义如下
class EmployeeType {
  private Long id;
  private String name; // 例如 "Teachers", "Carers"

  // Getters and Setters
}

import org.hibernate.criterion.DetachedCriteria;
import org.hibernate.criterion.Restrictions;

// ...

// 为 EmployeeEntity 创建 DetachedCriteria 实例
DetachedCriteria detachedCriteria = DetachedCriteria.forClass(EmployeeEntity.class, "employee");

// 关联 EmployeeEntity 的 type 属性到 EmployeeType 实体，并起别名 "employeeType"
detachedCriteria.createAlias("employee.type", "employeeType");

// 添加过滤条件：员工类型名称等于 "Teachers" 或 "Carers"
// 这里的例子展示了如何筛选单一类型，若需同时筛选多个类型，可以使用 Disjunction (OR)
// 例如，如果只需要筛选 Teachers：
detachedCriteria.add(Restrictions.eq("employeeType.name", "Teachers"));

// 如果需要筛选 Teachers 和 Carers 的“并集”结果，可以这样构建：
// detachedCriteria.add(Restrictions.or(
//     Restrictions.eq("employeeType.name", "Teachers"),
//     Restrictions.eq("employeeType.name", "Carers")
// ));

// 还可以添加其他条件，例如按员工姓名过滤
// detachedCriteria.add(Restrictions.ilike("employee.name", "%John%", MatchMode.ANYWHERE));

/**
 * 根据页码和每页大小计算查询的起始索引。
 *
 * @param pageNumber 基于1的页码
 * @param pageSize 每页显示的记录数
 * @return 查询的起始索引
 */
public Integer calculateOffset(Integer pageNumber, Integer pageSize) {
    if (pageNumber == null || pageNumber < 1) {
        pageNumber = 1; // 默认第一页
    }
    if (pageSize == null || pageSize < 1) {
        pageSize = 10; // 默认每页10条
    }
    return (pageNumber - 1) * pageSize;
}

// 示例用法
Integer currentPage = 1; // 假设从前端获取的页码
Integer pageSize = 10;   // 假设从前端获取的每页大小

Integer offset = calculateOffset(currentPage, pageSize);

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.criterion.Criteria;

import java.util.List;

// 假设你有一个 SessionFactory
// @Autowired
// private SessionFactory sessionFactory;

/**
 * 根据 DetachedCriteria 和分页参数执行查询。
 *
 * @param detachedCriteria 包含所有过滤条件的 DetachedCriteria 实例
 * @param offset 查询的起始索引
 * @param pageSize 每页显示的记录数
 * @return 符合条件并分页后的结果列表
 */
public List<EmployeeEntity> findByCriteria(DetachedCriteria detachedCriteria, Integer offset, Integer pageSize) {
    Session session = null;
    try {
        // 获取当前会话或打开新会话
        // session = sessionFactory.getCurrentSession(); // 或 sessionFactory.openSession();
        // 这里的 session 获取方式取决于你的Spring/Hibernate配置

        // 临时模拟一个 Session 和 Criteria
        // 在实际应用中，你需要从 SessionFactory 获取一个真实的 Session
        // 并通过 detachedCriteria.getExecutableCriteria(session) 获取 Criteria 实例
        Criteria executableCriteria = null; // 实际应为 detachedCriteria.getExecutableCriteria(session);

        // 模拟 Criteria 的分页设置
        // executableCriteria.setFirstResult(offset);
        // executableCriteria.setMaxResults(pageSize);

        // 模拟执行查询
        // List<EmployeeEntity> resultList = executableCriteria.list();
        // return resultList;

        // 由于没有真实的SessionFactory，这里返回一个空列表作为示例
        System.out.println("Executing query with offset: " + offset + ", pageSize: " + pageSize);
        System.out.println("Criteria built: " + detachedCriteria.toString());
        return List.of(
            new EmployeeEntity(1L, new EmployeeType(101L, "Teachers"), "Alice"),
            new EmployeeEntity(2L, new EmployeeType(102L, "Carers"), "Bob")
        ); // 实际应返回查询结果
    } catch (Exception e) {
        // 异常处理
        e.printStackTrace();
        throw new RuntimeException("Error executing criteria query", e);
    } finally {
        // 关闭会话（如果是由 openSession() 打开的）
        // if (session != null && session.isOpen()) {
        //     session.close();
        // }
    }
}

// 调用示例
// List<EmployeeEntity> resultList = findByCriteria(detachedCriteria, offset, pageSize);
// System.out.println("Query Results: " + resultList);