short section on named queries

This commit is contained in:
Gavin 2023-05-13 19:23:33 +02:00 committed by Christian Beikov
parent 1e22d1bb3d
commit 65a500182f
1 changed files with 19 additions and 0 deletions

View File

@ -724,6 +724,25 @@ We have to make sure that the class with the `@NamedQuery` annotation will be sc
The `@NamedNativeQuery` lets us do the same for native SQL queries. The `@NamedNativeQuery` lets us do the same for native SQL queries.
.Executing named queries
|===
| Kind of query | `Session` method | `EntityManager` method | `Query` execution method
| Selection query | `createNamedSelectionQuery(String,Class)` | `createNamedQuery(String,Class)` | `getResultList()`, `getSingleResult()`, or `getSingleResultOrNull()`
| Mutation query | `createNamedMutationQuery(String)` | `createNamedQuery(String)` | `executeUpdate()`
|===
We execute our named query as follows:
[source,java]
----
em.createNamedQuery("10BooksByTitle")
.setParameter("titlePattern", titlePattern)
.getResultList()
----
Note that the code which executes the named query is not aware of whether the query was written in HQL or in native SQL, making it slightly easier to change and optimize the query later.
[[jdbc]] [[jdbc]]
=== Interacting directly with JDBC === Interacting directly with JDBC