HHH-19364 change links in javadoc to point to new APIs

Author: gavinking

hibernate-core/src/main/java/org/hibernate/query/Order.java

@@ -18,22 +18,25 @@
 /**
  * A rule for sorting a query result set.
  * <p>
- * This is a convenience class which allows query result ordering
- * rules to be passed around the system before being applied to
- * a {@link Query} by calling {@link SelectionQuery#setOrder(Order)}.
+ * This is a convenience class which allows query result ordering rules to be
+ * passed around the system before being applied to a {@link Query} by calling
+ * {@link org.hibernate.query.programmatic.SelectionSpecification#sort(Order)}.
  * <pre>
- * session.createSelectionQuery("from Book b join b.authors a where a.name = :name", Book.class)
+ * SelectionSpecification.create(Book.class,
+ *             "from Book b join b.authors a where a.name = :name")
+ *         .sort(asc(Book_.publicationDate))
+ *         .createQuery(session)
  *         .setParameter("name", authorName)
- *         .setOrder(asc(Book_.publicationDate))
  *         .getResultList();
  * </pre>
  * <p>
  * {@code Order}s may be stacked using {@link List#of} and
- * {@link SelectionQuery#setOrder(List)}.
+ * {@link org.hibernate.query.programmatic.SelectionSpecification#resort(List)}.
  * <pre>
- * session.createSelectionQuery("from Book b join b.authors a where a.name = :name", Book.class)
+ * SelectionSpecification.create(Book.class,
+ *             "from Book b join b.authors a where a.name = :name")
+ *         .sort(List.of(asc(Book_.publicationDate), desc(Book_.ssn)))
  *         .setParameter("name", authorName)
- *         .setOrder(List.of(asc(Book_.publicationDate), desc(Book_.ssn)))
  *         .getResultList();
  * </pre>
  * <p>
@@ -49,8 +52,8 @@
  *          used by Hibernate Data Repositories to implement Jakarta Data
  *          query methods.
  *
- * @see SelectionQuery#setOrder(Order)
- * @see SelectionQuery#setOrder(java.util.List)
+ * @see org.hibernate.query.programmatic.SelectionSpecification#sort(Order)
+ * @see org.hibernate.query.programmatic.SelectionSpecification#resort(List)
  * @see org.hibernate.query.restriction.Restriction
  *
  * @author Gavin King

hibernate-core/src/main/java/org/hibernate/query/programmatic/MutationSpecification.java

@@ -14,7 +14,6 @@
 import org.hibernate.StatelessSession;
 import org.hibernate.query.IllegalMutationQueryException;
 import org.hibernate.query.MutationQuery;
-import org.hibernate.query.SelectionQuery;
 import org.hibernate.query.programmatic.internal.MutationSpecificationImpl;
 import org.hibernate.query.restriction.Restriction;
 
@@ -28,7 +27,7 @@
  * kinds.
  * <p>
  * Once all {@linkplain #restrict restrictions} are specified, call
- * {@link #createQuery createQuery()} to obtain an {@linkplain SelectionQuery
+ * {@link #createQuery createQuery()} to obtain an {@linkplain MutationQuery
  * executable mutation query object}.
  *
  * @param <T> The entity type which is the target of the mutation.