1. Общий обзор
В этой статье показано, как реализовать разбиение на страницы в Java Persistence API.
В ней объясняется, как выполнять разбиение на страницы с помощью базового JQL и более типобезопасных API, основанных на критериях, обсуждаются преимущества и известные проблемы каждой реализации.
2. Разбивка на страницы с помощью JQL и API setFirstResult(), setMaxResults()
Самый простой способ реализовать разбиение на страницы – это использовать язык запросов Java - создать запрос и настроить его с помощью setMaxResults и setFirstResult:
Query query = entityManager.createQuery("From Foo");
int pageNumber = 1;
int pageSize = 10;
query.setFirstResult((pageNumber-1) * pageSize);
query.setMaxResults(pageSize);
List <Foo> fooList = query.getResultList();
API очень прост:
- setFirstResult(int): Устанавливает положение смещения в результирующем наборе для начала разбивки на страницы
- setMaxResults(int): Задает максимальное количество объектов, которые должны быть включены в страницу
2.1. Общее количество и последняя страница
Для более полного решения проблемы разбивки на страницы нам также необходимо получить общее количество результатов:
Query queryTotal = entityManager.createQuery
("Select count(f.id) from Foo f");
long countResult = (long)queryTotal.getSingleResult();
Вычисление последней страницы также очень полезно:
int pageSize = 10;
int pageNumber = (int) ((countResult / pageSize) + 1);
Обратите внимание, что такой подход к получению общего количества результатов в результирующем наборе требует дополнительного запроса (для подсчета).
3. Разбивка на страницы с помощью JQL с использованием идентификаторов сущностей
Простая альтернативная стратегия разбивки на страницы заключается в том, чтобы сначала получить полные идентификаторы, а затем, на их основе, получить полные объекты. Это позволяет лучше контролировать выборку объектов, но также означает, что для получения идентификаторов необходимо загрузить всю таблицу целиком:
Query queryForIds = entityManager.createQuery(
"Select f.id from Foo f order by f.lastName");
List<Integer> fooIds = queryForIds.getResultList();
Query query = entityManager.createQuery(
"Select f from Foo e where f.id in :ids");
query.setParameter("ids", fooIds.subList(0,10));
List<Foo> fooList = query.getResultList();
Наконец, также обратите внимание, что для получения полных результатов требуется 2 различных запроса.
4. Разбивка на страницы с помощью JPA С использованием Criteria API
Далее давайте рассмотрим, как мы можем использовать JPA Criteria API для реализации разбивки на страницы:
int pageSize = 10;
CriteriaBuilder criteriaBuilder = entityManager
.getCriteriaBuilder();
CriteriaQuery<Foo> criteriaQuery = criteriaBuilder
.createQuery(Foo.class);
Root<Foo> from = criteriaQuery.from(Foo.class);
CriteriaQuery<Foo> select = criteriaQuery.select(from);
TypedQuery<Foo> typedQuery = entityManager.createQuery(select);
typedQuery.setFirstResult(0);
typedQuery.setMaxResults(pageSize);
List<Foo> fooList = typedQuery.getResultList();
Это полезно, когда целью является создание динамических, отказоустойчивых запросов. В отличие от “жестко запрограммированных”, “основанных на строках” запросов JQL или HQL, JPA Criteria сокращает количество сбоев во время выполнения, поскольку компилятор динамически проверяет запросы на наличие ошибок.
С помощью критериев JPA получить общее количество объектов достаточно просто:
CriteriaQuery<Long> countQuery = criteriaBuilder
.createQuery(Long.class);
countQuery.select(criteriaBuilder.count(
countQuery.from(Foo.class)));
Long count = entityManager.createQuery(countQuery)
.getSingleResult();
Конечным результатом является решение для полной разбивки на страницы с использованием JPA Criteria API:
int pageNumber = 1;
int pageSize = 10;
CriteriaBuilder criteriaBuilder = entityManager.getCriteriaBuilder();
CriteriaQuery<Long> countQuery = criteriaBuilder
.createQuery(Long.class);
countQuery.select(criteriaBuilder
.count(countQuery.from(Foo.class)));
Long count = entityManager.createQuery(countQuery)
.getSingleResult();
CriteriaQuery<Foo> criteriaQuery = criteriaBuilder
.createQuery(Foo.class);
Root<Foo> from = criteriaQuery.from(Foo.class);
CriteriaQuery<Foo> select = criteriaQuery.select(from);
TypedQuery<Foo> typedQuery = entityManager.createQuery(select);
while (pageNumber < count.intValue()) {
typedQuery.setFirstResult(pageNumber - 1);
typedQuery.setMaxResults(pageSize);
System.out.println("Current page: " + typedQuery.getResultList());
pageNumber += pageSize;
}
5. Заключение
В этой статье рассмотрены основные параметры разбивки на страницы, доступные в JPA.
У некоторых из них есть недостатки, в основном связанные с производительностью запросов, но они обычно компенсируются улучшенным контролем и общей гибкостью.
Оригинал статьи: https://www.baeldung.com/jpa-pagination