public Interface Query<R>

• a query written in HQL,
• a named query written in HQL or native SQL, or
• a criteria query.

The subtype NativeQuery represents a query written in native SQL.

This type simply mixes the TypedQuery interface defined by JPA with SelectionQuery and MutationQuery. Unfortunately, JPA does not distinguish between selection queries and mutation queries, so we lose that distinction here. However, every Query may logically be classified as one or the other.

A Query may be obtained from the org.hibernate.Session by calling:

• QueryProducer#createQuery(String, Class), passing the HQL as a string,
• QueryProducer#createQuery(jakarta.persistence.criteria.CriteriaQuery), passing a criteria object, or
• QueryProducer#createNamedQuery(String, Class) passing the name of a query defined using jakarta.persistence.NamedQuery or jakarta.persistence.NamedNativeQuery.

A Query controls how a query is executed, and allows arguments to be bound to its parameters.

• Selection queries are usually executed using getResultList() or getSingleResult().
• The methods setMaxResults(int) and setFirstResult(int) control limits and pagination.
• The various overloads of setParameter(String, Object) and setParameter(int, Object) allow arguments to be bound to named and ordinal parameters defined by the query.

Note that this interface offers no real advantages over SelectionQuery except for compatibility with the JPA-defined TypedQuery interface.