[hibernate#950] Minor fixes to the javadoc

Author: DavideD

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

@@ -1394,7 +1394,7 @@ interface StatelessSession extends Closeable {
 		 *
 		 * @param association a lazy-loaded association
 		 *
-		 * @return the fetched association, via a {@code CompletionStage}
+		 * @return the fetched association, via a {@code Uni}
 		 *
 		 * @see org.hibernate.Hibernate#initialize(Object)
 		 */
@@ -1688,6 +1688,14 @@ interface SessionFactory extends AutoCloseable {
 		 * Perform work using a {@link Session reactive session} within an
 		 * associated {@link Transaction transaction}.
 		 * <p>
+		 * <il>
+		 * <li>If there is already a session associated with the
+		 * current reactive stream, then the work will be executed using that
+		 * session.
+		 * <li>Otherwise, if there is no session associated with the
+		 * current stream, a new stateless session will be created.
+		 * </il>
+		 * <p>
 		 * The session will be {@link Session#flush() flushed} and closed
 		 * automatically, and the transaction committed automatically.
 		 *
@@ -1703,6 +1711,14 @@ interface SessionFactory extends AutoCloseable {
 		 * Perform work using a {@link StatelessSession reactive session} within an
 		 * associated {@link Transaction transaction}.
 		 * <p>
+		 * <il>
+		 * <li>If there is already a stateless session associated with the
+		 * current reactive stream, then the work will be executed using that
+		 * session.
+		 * <li>Otherwise, if there is no stateless session associated with the
+		 * current stream, a new stateless session will be created.
+		 * </il>
+		 * <p>
 		 * The session will be closed automatically and the transaction committed automatically.
 		 *
 		 * @param work a function which accepts the stateless session and returns
@@ -1736,10 +1752,10 @@ interface SessionFactory extends AutoCloseable {
 		 * <p>
 		 * <il>
 		 * <li>If there is already a stateless session associated with the
-		 * current reactive stream, then the work will be executed using that
+		 * current reactive stream and given tenant id, then the work will be executed using that
 		 * session.
 		 * <li>Otherwise, if there is no stateless session associated with the
-		 * current stream, a new stateless session will be created.
+		 * current stream and given tenant id, a new stateless session will be created.
 		 * </il>
 		 * <p>
 		 * The session will be closed automatically.
@@ -1754,6 +1770,14 @@ interface SessionFactory extends AutoCloseable {
 		 * Perform work using a {@link Session reactive session} for a
 		 * specified tenant within an associated {@link Transaction transaction}.
 		 * <p>
+		 * <il>
+		 * <li>If there is already a session associated with the
+		 * current reactive stream and given tenant id, then the work will be executed using that
+		 * session.
+		 * <li>Otherwise, if there is no session associated with the
+		 * current stream and given tenant id, a new stateless session will be created.
+		 * </il>
+		 * <p>
 		 * The session will be {@link Session#flush() flushed} and closed
 		 * automatically, and the transaction committed automatically.
 		 *
@@ -1770,6 +1794,14 @@ interface SessionFactory extends AutoCloseable {
 		 * Perform work using a {@link StatelessSession reactive session} for a
 		 * specified tenant within an associated {@link Transaction transaction}.
 		 * <p>
+		 * <il>
+		 * <li>If there is already a stateless session associated with the
+		 * current reactive stream and given tenant id, then the work will be executed using that
+		 * session.
+		 * <li>Otherwise, if there is no stateless session associated with the
+		 * current stream and given tenant id, a new stateless session will be created.
+		 * </il>
+		 * <p>
 		 * The session will be closed automatically and the transaction committed automatically.
 		 *
 		 * @param tenantId the id of the tenant

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

@@ -1682,6 +1682,14 @@ interface SessionFactory extends AutoCloseable {
 		 * Perform work using a {@link Session reactive session} within an
 		 * associated {@link Transaction transaction}.
 		 * <p>
+		 * <il>
+		 * <li>If there is already a stateless session associated with the
+		 * current reactive stream, then the work will be executed using that
+		 * session.
+		 * <li>Otherwise, if there is no stateless session associated with the
+		 * current stream, a new stateless session will be created.
+		 * </il>
+		 * <p>
 		 * The session will be {@link Session#flush() flushed} and closed
 		 * automatically, and the transaction committed automatically.
 		 *
@@ -1697,6 +1705,14 @@ interface SessionFactory extends AutoCloseable {
 		 * Perform work using a {@link Session reactive session} for a
 		 * specified tenant within an associated {@link Transaction transaction}.
 		 * <p>
+		 * <il>
+		 * <li>If there is already a session associated with the
+		 * current reactive stream and the given tenant, then the work will be executed using that
+		 * session.
+		 * <li>Otherwise, if there is no stateless session associated with the
+		 * current stream and the given tenant, a new stateless session will be created.
+		 * </il>
+		 * <p>
 		 * The session will be {@link Session#flush() flushed} and closed
 		 * automatically, and the transaction committed automatically.
 		 *
@@ -1713,6 +1729,14 @@ interface SessionFactory extends AutoCloseable {
 		 * Perform work using a {@link StatelessSession reactive session} within an
 		 * associated {@link Transaction transaction}.
 		 * <p>
+		 * <il>
+		 * <li>If there is already a stateless session associated with the
+		 * current reactive stream, then the work will be executed using that
+		 * session.
+		 * <li>Otherwise, if there is no stateless session associated with the
+		 * current stream, a new stateless session will be created.
+		 * </il>
+		 * <p>
 		 * The session will be closed automatically, and the transaction committed automatically.
 		 *
 		 * @param work a function which accepts the stateless session and returns
@@ -1727,6 +1751,14 @@ interface SessionFactory extends AutoCloseable {
 		 * Perform work using a {@link StatelessSession reactive session} within an
 		 * associated {@link Transaction transaction}.
 		 * <p>
+		 * <il>
+		 * <li>If there is already a stateless session associated with the
+		 * current reactive stream and the given tenant, then the work will be executed using that
+		 * session.
+		 * <li>Otherwise, if there is no stateless session associated with the
+		 * current stream, a new stateless session will be created.
+		 * </il>
+		 * <p>
 		 * The session will be closed automatically, and the transaction committed automatically.
 		 *
 		 * @param tenantId the id of the tenant