HHH-19468 allow an EnabledFetchProfile to be apply()d to a Session or Query

Author: gavinking

documentation/src/main/asciidoc/introduction/Advanced.adoc

@@ -1140,14 +1140,29 @@ We may define as many different fetch profiles as we like.
 | `@FetchProfileOverride` | Specifies the fetch strategy for the annotated association, in a given fetch profile
 |===
 
-A fetch profile must be explicitly enabled for a given session by calling link:{doc-javadoc-url}org/hibernate/Session.html#enableFetchProfile(java.lang.String)[`enableFetchProfile()`]:
+A fetch profile must be explicitly enabled for a given session by passing the name of the profile to link:{doc-javadoc-url}org/hibernate/Session.html#enableFetchProfile(java.lang.String)[`enableFetchProfile()`]:
 
 [source,java]
 ----
 session.enableFetchProfile(Book_.PROFILE_EAGER_BOOK);
 Book eagerBook = session.find(Book.class, bookId);
 ----
 
+Alternatively, an instance of link:{doc-javadoc-url}org/hibernate/EnabledFetchProfile.html[`EnabledFetchProfile`] may be obtained in a type safe way from the static metamodel, and applied to the session:
+
+[source,java]
+----
+Book_._EagerBook.enable(session);
+Book eagerBook = session.find(Book.class, bookId);
+----
+
+An `EnabledFetchProfile` may even be used as a `FindOption`:
+
+[source,java]
+----
+Book eagerBook = entityManager.find(Book.class, bookId, Book_._EagerBook);
+----
+
 So why or when might we prefer named fetch profiles to entity graphs?
 Well, it's really hard to say.
 It's nice that this feature _exists_, and if you love it, that's great.

hibernate-core/src/main/java/org/hibernate/EnabledFetchProfile.java

@@ -5,12 +5,28 @@
 package org.hibernate;
 
 import jakarta.persistence.FindOption;
+import org.hibernate.query.SelectionQuery;
 
 /**
  * A {@link jakarta.persistence.FindOption} which requests a named
  * {@linkplain org.hibernate.annotations.FetchProfile fetch profile}.
+ * <p>
+ * An instance of this class may be obtained in a type safe way
+ * from the static metamodel for the class annotated
+ * {@link org.hibernate.annotations.FetchProfile @FetchProfile}.
+ * <p>
+ * An {@code EnabledFetchProfile} may be passed as an option to
+ * {@link Session#find(Class, Object, FindOption...) find()}.
+ * <pre>
+ * session.find(Book.class, isbn, Book_._WithAuthors)
+ * </pre>
+ * Alternatively, it may be {@linkplain #enable(Session) applied}
+ * to a {@code Session} or {@code Query}.
+ * <pre>
+ * Book_._WithAuthors.enable(session)
+ * </pre>
  *
- * @param profileName the {@link org.hibernate.annotations.FetchProfile#name()}
+ * @param profileName the {@linkplain org.hibernate.annotations.FetchProfile#name profile name}
  *
  * @since 7.0
  *
@@ -21,4 +37,20 @@
  */
 public record EnabledFetchProfile(String profileName)
 		implements FindOption {
+
+	/**
+	 * Enable the fetch profile represented by this
+	 * object in the given session.
+	 */
+	public void enable(Session session) {
+		session.enableFetchProfile(profileName);
+	}
+
+	/**
+	 * Enable the fetch profile represented by this
+	 * object during execution of the given query.
+	 */
+	public void enable(SelectionQuery<?> query) {
+		query.enableFetchProfile(profileName);
+	}
 }