Изучаем Java EE 7 - [96]

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-операторы, как только запустится приложение, а не делать это каждый раз при выполнении запроса.

Именованные запросы — это статические запросы, выражаемые метаданными внутри либо аннотации @NamedQuery, либо XML-эквивалента. Для определения этих запросов, пригодных для повторного использования, снабдите сущность аннотацией @NamedQuery, которая принимает два элемента: имя запроса и его содержимое. Итак, внесем изменения для сущности Customer и статически определим три запроса с использованием аннотаций (листинг 6.22).

Листинг 6.22. Определение именованных запросов для сущности Customer

@Entity
@NamedQueries({
··@NamedQuery(name = "findAll", query="select c from Customer c"),

··@NamedQuery(name = "findVincent", 

··············query="select c from Customer c where c.firstName = 'Винсент'"),
··@NamedQuery(name = "findWithParam",

··············query="select c from Customer c where c.firstName =:fname")
})
public class Customer {
··@Id @GeneratedValue
··private Long id;
··private String firstName;
··private String lastName;
··private Integer age;
··private String email;
··@OneToOne
··@JoinColumn(name = "address_fk")
··private Address address;
··// Конструкторы, геттеры, сеттеры
}

Поскольку для сущности Customer определяется более одного именованного запроса, здесь применяется аннотация @NamedQueries, которая принимает массив @NamedQuery. Первый запрос findAll обеспечивает выборку всех клиентов из базы данных без каких-либо ограничений (оператор WHERE отсутствует). Запрос findWithParam задействует параметр: fname для ограничения выборки клиентов согласно значению firstName. В листинге 6.22 показан массив @NamedQuery, однако если бы в случае с Customer имел место один запрос, то он выглядел бы следующим образом:

@Entity
@NamedQuery(name = "findAll", query="select c from Customer c")
public class Customer {…}

Способ выполнения таких именованных запросов схож с тем, что применяется для выполнения динамических запросов. Вызывается метод EntityManager.createNamedQuery(), которому передается имя запроса, определяемое аннотациями. Этот метод возвращает Query или TypedQuery, который может быть использован для задания параметров, максимального количества результатов, режимов выборки и т. д. Чтобы выполнить запрос findAll, напишите следующий код: