Hibernate
/
hibernate-orm
mirror of https://github.com/hibernate/hibernate-orm
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

short section on named queries

This commit is contained in:
Gavin 2023-05-13 19:23:33 +02:00 committed by Gavin King
parent 032fc0753f
commit c2fe18796f
1 changed files with 19 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
documentation/src/main/asciidoc/introduction/Interacting.adoc
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.
.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]]
=== Interacting directly with JDBC