Hibernate 中分页简介

2019-07-31 750 words 2 minutes

Contents

1. 概述

本文快速介绍了 Hibernate 中的分页。我们将查看标准 HQL 以及ScrollableResults API，最后，使用 Hibernate Criteria 进行分页。

2. 使用 HQL 和setFirstResult、setMaxResults API进行分页

在 Hibernate 中进行分页的最简单和最常见的方法是使用 HQL：

Session session = sessionFactory.openSession();
Query query = sess.createQuery("From Foo");
query.setFirstResult(0);
query.setMaxResults(10);
List<Foo> fooList = fooList = query.list();

这个例子使用了一个基本的Foo实体，与 JPA 的 JQL 实现非常相似——唯一的区别是查询语言。

如果我们打开Hibernate 的日志记录，我们将看到以下 SQL 正在运行：

Hibernate: 
    select
        foo0_.id as id1_1_,
        foo0_.name as name2_1_ 
    from
        Foo foo0_ limit ?

2.1. 总计数和最后一页

**如果不知道实体的总数，**分页解决方案是不完整的：

String countQ = "Select count (f.id) from Foo f";
Query countQuery = session.createQuery(countQ);
Long countResults = (Long) countQuery.uniqueResult();

最后，根据总数和给定的页面大小，我们可以计算最后一页：

int pageSize = 10;
int lastPageNumber = (int) (Math.ceil(countResults / pageSize));

在这一点上，我们可以看一个完整的分页示例，我们正在计算最后一页，然后检索它：

@Test
public void givenEntitiesExist_whenRetrievingLastPage_thenCorrectSize() {
    int pageSize = 10;
    String countQ = "Select count (f.id) from Foo f";
    Query countQuery = session.createQuery(countQ);
    Long countResults = (Long) countQuery.uniqueResult();
    int lastPageNumber = (int) (Math.ceil(countResults / pageSize));
    Query selectQuery = session.createQuery("From Foo");
    selectQuery.setFirstResult((lastPageNumber - 1) * pageSize);
    selectQuery.setMaxResults(pageSize);
    List<Foo> lastPage = selectQuery.list();
    assertThat(lastPage, hasSize(lessThan(pageSize + 1)));
}

3. 使用 HQL 和 ScrollableResults API 使用 Hibernate 进行分页

使用ScrollableResults 实现分页有可能减少数据库调用。这种方法在程序滚动时流式传输结果集，因此无需重复查询以填充每个页面：

String hql = "FROM Foo f order by f.name";
Query query = session.createQuery(hql);
int pageSize = 10;
ScrollableResults resultScroll = query.scroll(ScrollMode.FORWARD_ONLY);
resultScroll.first();
resultScroll.scroll(0);
List<Foo> fooPage = Lists.newArrayList();
int i = 0;
while (pageSize > i++) {
    fooPage.add((Foo) resultScroll.get(0));
    if (!resultScroll.next())
        break;
}

此方法不仅省时（仅一次数据库调用），而且允许用户无需额外查询即可访问结果集的总数：

resultScroll.last();
int totalResults = resultScroll.getRowNumber() + 1;

另一方面，请记住，虽然滚动非常有效，但大窗口可能会占用大量内存。

4. 使用 Criteria API 使用 Hibernate 进行分页

最后，让我们看一个更灵活的解决方案——使用标准：

Criteria criteria = session.createCriteria(Foo.class);
criteria.setFirstResult(0);
criteria.setMaxResults(pageSize);
List<Foo> firstPage = criteria.list();

Hibernate Criteria 查询 API 使得获取总数变得非常简单——通过使用Projection对象：

Criteria criteriaCount = session.createCriteria(Foo.class);
criteriaCount.setProjection(Projections.rowCount());
Long count = (Long) criteriaCount.uniqueResult();

如您所见，使用此 API 将产生比普通 HQL 更详细的代码，但该 API 是完全类型安全的并且更加灵活。