Изучаем Java EE 7

В приведенном далее коде JPQL-запрос обеспечивает выборку всех клиентов из базы данных. Результатом этого запроса является список, так что, когда вы вызываете метод getResultList(), он возвращает список экземпляров сущности Customer (List). Однако если вы знаете, что ваш запрос возвращает только одну сущность, используйте метод getSingleResult(). Он возвращает одну сущность и избегает работы по извлечению данных в виде списка.

Query query = em.createQuery("SELECT c FROM Customer c");

List customers = query.getResultList();

Этот JPQL-запрос возвращает объект Query. Когда вы вызываете метод query.getResultList(), он возвращает список нетипизированных объектов. Если вы хотите, чтобы этот же запрос возвратил список типа Customer, то вам нужно использовать TypedQuery следующим образом:

TypedQuery query =

····em.createQuery("SELECT c FROM Customer c", Customer.class);

List customers = query.getResultList();

Эта строка запроса также может динамически создаваться приложением, которое затем способно сгенерировать заранее не известный комплексный запрос во время выполнения. Конкатенация строк используется для динамического генерирования запроса в зависимости от соответствующих критериев.

String jpqlQuery = "SELECT c FROM Customer c";

if (someCriteria)

····jpqlQuery += "WHERE c.firstName = 'Бетти'";

query = em.createQuery(jpqlQuery);

List customers = query.getResultList();

Предыдущий запрос извлекает клиентов, для которых firstName имеет значение Бетти, однако вы можете захотеть передать параметр для firstName. Есть два возможных варианта для этого: с использованием имен или позиций. В приведенном далее примере я использую именованный параметр: fname (обратите внимание на символ «:») в запросе и привязываю его с помощью метода setParameter:

query = em.createQuery("SELECT c FROM Customer c where c.firstName =:fname");

query.setParameter("fname", "Бетти");

List customers = query.getResultList();

Обратите внимание, что имя параметра fname не содержит двоеточия, используемого в запросе. Код, включающий в себя позиционный параметр, выглядел бы следующим образом:

query = em.createQuery("SELECT c FROM Customer c where c.firstName =?1");

query.setParameter(1, "Бетти");

List customers = query.getResultList();

Если вам потребуется прибегнуть к разбиению на страницы для вывода списка клиентов частями по десять человек, то можете воспользоваться методом setMaxResults, как показано далее:

query = em.createQuery("SELECT c FROM Customer c", Customer.class);

query.setMaxResults(10);

List customers = query.getResultList();

В случае с динамическими запросами необходимо принимать во внимание, во что обходится преобразование JPQL-строк в SQL-операторы во время выполнения. Поскольку запрос генерируется динамически и его нельзя предсказать, поставщику постоянства приходится разбирать JPQL-строку, извлекать метаданные объектно-реляционного отображения и генерировать эквивалентный SQL-оператор. Обработка каждого из таких динамических запросов может отрицательно сказаться на производительности. Если вам потребуется выполнить статические запросы, которые являются неизменяемыми, и вы захотите избежать этих накладных расходов, то можете вместо этого обратиться к именованным запросам.

Именованные запросы

Именованные запросы отличаются от динамических тем, что являются статическими и неизменяемыми. В дополнение к их статической природе, которая не обеспечивает гибкости динамических запросов, выполнение именованных запросов может быть более эффективным, поскольку поставщик постоянства получает возможность преобразовать JPQL-строки в SQL-операторы, как только запустится приложение, а не делать это каждый раз при выполнении запроса.