diff --git a/hibernate-core/src/main/java/org/hibernate/StatelessSession.java b/hibernate-core/src/main/java/org/hibernate/StatelessSession.java index 1538fd2703..4bbc76ca7a 100644 --- a/hibernate-core/src/main/java/org/hibernate/StatelessSession.java +++ b/hibernate-core/src/main/java/org/hibernate/StatelessSession.java @@ -267,9 +267,15 @@ public interface StatelessSession extends SharedSessionContract { /** * Fetch an association or collection that's configured for lazy loading. + *
+ * Book book = session.get(Book.class, isbn); // book is immediately detached + * session.fetch(book.getAuthors()); // fetch the associated authors + * book.getAuthors().forEach(author -> ... ); // iterate the collection + **
* Warning: this operation in a stateless session is quite sensitive - * to data aliasing effects and should be used with great care. + * to data aliasing effects and should be used with great care. It's + * usually better to fetch associations using eager join fetching. * * @param association a lazy-loaded association *