Skip to content

Commit 7382668

Browse files
committed
[#1893] Update .fetch javadoc
1 parent 91861b9 commit 7382668

File tree

2 files changed

+20
-5
lines changed

2 files changed

+20
-5
lines changed

hibernate-reactive-core/src/main/java/org/hibernate/reactive/mutiny/Mutiny.java

+10-3
Original file line numberDiff line numberDiff line change
@@ -848,16 +848,23 @@ default Uni<Void> lock(Object entity, LockModeType lockModeType) {
848848

849849
/**
850850
* Asynchronously fetch an association that's configured for lazy loading.
851-
*
851+
* <p>
852852
* <pre>
853853
* {@code session.fetch(author.getBook()).thenAccept(book -> print(book.getTitle()));}
854854
* </pre>
855-
*
856-
* @param association a lazy-loaded association
855+
* </p>
856+
* <p>
857+
* It can also initialize proxys. For example:
858+
* <pre>
859+
* {@code session.fetch(session.getReference(Author.class, authorId))}
860+
* </pre>
861+
* </p>
862+
* @param association a lazy-loaded association, or a proxy
857863
*
858864
* @return the fetched association, via a {@code Uni}
859865
*
860866
* @see Mutiny#fetch(Object)
867+
* @see #getReference(Class, Object)
861868
* @see org.hibernate.Hibernate#initialize(Object)
862869
*/
863870
<T> Uni<T> fetch(T association);

hibernate-reactive-core/src/main/java/org/hibernate/reactive/stage/Stage.java

+10-2
Original file line numberDiff line numberDiff line change
@@ -877,16 +877,24 @@ default CompletionStage<Void> lock(Object entity, LockModeType lockModeType) {
877877

878878
/**
879879
* Asynchronously fetch an association that's configured for lazy loading.
880-
*
880+
* <p>
881881
* <pre>
882882
* {@code session.fetch(author.getBook()).thenAccept(book -> print(book.getTitle()))}
883883
* </pre>
884+
* </p>
885+
* <p>
886+
* It can also initialize proxys. For example:
887+
* <pre>
888+
* {@code session.fetch(session.getReference(Author.class, authorId))}
889+
* </pre>
890+
* </p>
884891
*
885-
* @param association a lazy-loaded association
892+
* @param association a lazy-loaded association, or a proxy
886893
*
887894
* @return the fetched association, via a {@code CompletionStage}
888895
*
889896
* @see Stage#fetch(Object)
897+
* @see #getReference(Class, Object)
890898
* @see org.hibernate.Hibernate#initialize(Object)
891899
*/
892900
<T> CompletionStage<T> fetch(T association);

0 commit comments

Comments
 (0)