remove AbstractSessionImpl, which is obsolete

minor improvements to jdoc

hibernate-core/src/main/java/org/hibernate/internal/AbstractSessionImpl.java

@@ -1,32 +0,0 @@
-/*
- * Hibernate, Relational Persistence for Idiomatic Java
- *
- * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
- * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
- */
-package org.hibernate.internal;
-
-import java.io.Serializable;
-
-import org.hibernate.engine.spi.SessionImplementor;
-import org.hibernate.engine.spi.SharedSessionContractImplementor;
-import org.hibernate.event.spi.EventSource;
-import org.hibernate.resource.jdbc.spi.JdbcSessionOwner;
-import org.hibernate.resource.transaction.spi.TransactionCoordinatorBuilder.Options;
-import org.hibernate.type.descriptor.WrapperOptions;
-
-/**
- * Functionality common to stateless and stateful sessions
- *
- * @author Gavin King
- */
-public abstract class AbstractSessionImpl
-		extends AbstractSharedSessionContract
-		implements Serializable, SharedSessionContractImplementor, JdbcSessionOwner, SessionImplementor, EventSource,
-		Options, WrapperOptions {
-
-	protected AbstractSessionImpl(SessionFactoryImpl factory, SessionCreationOptions options) {
-		super( factory, options );
-	}
-
-}

hibernate-core/src/main/java/org/hibernate/internal/AbstractSharedSessionContract.java

@@ -104,8 +104,9 @@ import jakarta.persistence.criteria.CriteriaUpdate;
 import static java.lang.Boolean.TRUE;
 
 /**
- * Base class for SharedSessionContract/SharedSessionContractImplementor
- * implementations.  Intended for Session and StatelessSession implementations
+ * Base class for implementations of {@link org.hibernate.SharedSessionContract} and
+ * {@link SharedSessionContractImplementor}. Intended for concrete implementations of
+ * {@link org.hibernate.Session} and {@link org.hibernate.StatelessSession}.
  * <P/>
  * NOTE: This implementation defines access to a number of instance state values
  * in a manner that is not exactly concurrent-access safe.  However, a Session/EntityManager
@@ -118,6 +119,9 @@ import static java.lang.Boolean.TRUE;
  *     <li>{@link #getTransaction()} (and therefore related methods such as {@link #beginTransaction()}, etc)</li>
  * </ul>
  *
+ * @see SessionImpl
+ * @see StatelessSessionImpl
+ *
  * @author Steve Ebersole
  */
 public abstract class AbstractSharedSessionContract implements SharedSessionContractImplementor {

hibernate-core/src/main/java/org/hibernate/internal/SessionImpl.java

@@ -129,10 +129,12 @@ import org.hibernate.proxy.LazyInitializer;
 import org.hibernate.query.Query;
 import org.hibernate.query.SelectionQuery;
 import org.hibernate.query.UnknownSqlResultSetMappingException;
+import org.hibernate.resource.jdbc.spi.JdbcSessionOwner;
 import org.hibernate.resource.jdbc.spi.PhysicalConnectionHandlingMode;
 import org.hibernate.resource.transaction.TransactionRequiredForJoinException;
 import org.hibernate.resource.transaction.backend.jta.internal.JtaTransactionCoordinatorImpl;
 import org.hibernate.resource.transaction.spi.TransactionCoordinator;
+import org.hibernate.resource.transaction.spi.TransactionCoordinatorBuilder;
 import org.hibernate.resource.transaction.spi.TransactionStatus;
 import org.hibernate.stat.SessionStatistics;
 import org.hibernate.stat.internal.SessionStatisticsImpl;
@@ -148,6 +150,7 @@ import jakarta.persistence.FlushModeType;
 import jakarta.persistence.LockModeType;
 import jakarta.persistence.PersistenceException;
 import jakarta.persistence.TransactionRequiredException;
+import org.hibernate.type.descriptor.WrapperOptions;
 
 import static org.hibernate.cfg.AvailableSettings.JAKARTA_LOCK_SCOPE;
 import static org.hibernate.cfg.AvailableSettings.JAKARTA_LOCK_TIMEOUT;
@@ -165,11 +168,11 @@ import static org.hibernate.jpa.SpecHints.HINT_SPEC_LOCK_TIMEOUT;
 import static org.hibernate.jpa.SpecHints.HINT_SPEC_QUERY_TIMEOUT;
 
 /**
- * Concrete implementation of a the {@link Session} API.
+ * Concrete implementation of the {@link Session} API.
  * <p/>
  * Exposes two interfaces:<ul>
  * <li>{@link Session} to the application</li>
- * <li>{@link SessionImplementor} to other Hibernate components (SPI)</li>
+ * <li>{@link SessionImplementor} and {@link EventSource} to other Hibernate components (SPI)</li>
  * </ul>
  * <p/>
  * This class is not thread-safe.
@@ -181,8 +184,9 @@ import static org.hibernate.jpa.SpecHints.HINT_SPEC_QUERY_TIMEOUT;
  * @author Sanne Grinovero
  */
 public class SessionImpl
-		extends AbstractSessionImpl
-		implements SessionImplementor, LoadAccessContext, EventSource {
+		extends AbstractSharedSessionContract
+		implements Serializable, SharedSessionContractImplementor, JdbcSessionOwner, SessionImplementor, EventSource,
+				TransactionCoordinatorBuilder.Options, WrapperOptions, LoadAccessContext {
 	private static final EntityManagerMessageLogger log = HEMLogging.messageLogger( SessionImpl.class );
 
 	// Defaults to null which means the properties are the default

hibernate-core/src/main/java/org/hibernate/internal/StatelessSessionImpl.java

@@ -39,6 +39,15 @@ import org.hibernate.tuple.entity.EntityMetamodel;
 import jakarta.transaction.SystemException;
 
 /**
+ * Concrete implementation of the {@link StatelessSession} API.
+ * <p/>
+ * Exposes two interfaces:<ul>
+ * <li>{@link StatelessSession} to the application</li>
+ * <li>{@link org.hibernate.engine.spi.SharedSessionContractImplementor} to other Hibernate components (SPI)</li>
+ * </ul>
+ * <p/>
+ * This class is not thread-safe.
+ *
  * @author Gavin King
  * @author Steve Ebersole
  */