diff --git a/hibernate-core/src/main/java/org/hibernate/query/MutationQuery.java b/hibernate-core/src/main/java/org/hibernate/query/MutationQuery.java index e45eeb5d1f..046a9c097e 100644 --- a/hibernate-core/src/main/java/org/hibernate/query/MutationQuery.java +++ b/hibernate-core/src/main/java/org/hibernate/query/MutationQuery.java @@ -46,6 +46,11 @@ import jakarta.persistence.TemporalType; * {@link #setParameter(int, Object)} allow arguments to be bound to named * and ordinal parameters defined by the query. * + *
+ * session.createMutationQuery("delete Draft where lastUpdated < local date - ?1 year") + * .setParameter(1, years) + * .executeUpdate(); + ** * @author Steve Ebersole */ diff --git a/hibernate-core/src/main/java/org/hibernate/query/SelectionQuery.java b/hibernate-core/src/main/java/org/hibernate/query/SelectionQuery.java index 7a403deee2..f630155646 100644 --- a/hibernate-core/src/main/java/org/hibernate/query/SelectionQuery.java +++ b/hibernate-core/src/main/java/org/hibernate/query/SelectionQuery.java @@ -66,6 +66,24 @@ import org.hibernate.graph.GraphSemantic; * {@link #setParameter(int, Object)} allow arguments to be bound to named * and ordinal parameters defined by the query. * + * A query which returns multiple results should be executed via + * {@link #getResultList()}: + *
+ * List<Book> books = + * session.createSelectionQuery("from Book left join fetch authors where title like :title") + * .setParameter("title", title) + * .setMaxResults(50) + * .getResultList(); + *+ * A query which is expected to return exactly one on result should be executed + * via {@link #getSingleResult()}, or, if it might not return a result, + * {@link #getSingleResultOrNull()}: + *
+ * Book book = + * session.createSelectionQuery("from Book where isbn = ?1") + * .setParameter(1, isbn) + * .getSingleResultOrNull(); + **
* A query may have explicit fetch joins, specified using the syntax * {@code join fetch} in HQL, or via {@link jakarta.persistence.criteria.From#fetch}