Hibernate Pagination


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实体,与使用JQL实现的JPA非常相似 - 唯一的区别是查询语言。

如果我们打开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进行分页

使用ScrollableResul ts实现分页有可能减少数据库调用。当程序滚动时,此方法会对结果集进行流式处理,因此无需重复查询来填充每个页面:

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();

通过使用Projection对象,Hibernate Criteria查询API可以非常简单地获取总计数:

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

正如您所看到的,使用此API将导致代码比简单的HQL更简洁,但API完全类型安全且更灵活。