clean up very obsolete doc of SessionFactoryImpl

This commit is contained in:
Gavin 2022-12-29 20:25:12 +01:00 committed by Gavin King
parent 704c524e7c
commit b2586d5f2a
3 changed files with 16 additions and 17 deletions

View File

@ -134,21 +134,18 @@ import static org.hibernate.internal.util.config.ConfigurationHelper.getBoolean;
import static org.hibernate.query.QueryLogging.QUERY_MESSAGE_LOGGER; import static org.hibernate.query.QueryLogging.QUERY_MESSAGE_LOGGER;
/** /**
* Concrete implementation of the {@code SessionFactory} interface. Has the following * Concrete implementation of the {@link SessionFactory} API.
* responsibilities: * <p>
* Exposes two interfaces:
* <ul> * <ul>
* <li>caches configuration settings (immutably) * <li>{@link SessionFactory} to the application, and</li>
* <li>caches "compiled" mappings ie. {@code EntityPersister}s and * <li>{@link SessionImplementor} (an SPI interface) to other subsystems.</li>
* {@code CollectionPersister}s (immutable)
* <li>caches "compiled" queries (memory sensitive cache)
* <li>manages {@code PreparedStatement}s
* <li> delegates JDBC {@code Connection} management to the {@code ConnectionProvider}
* <li>factory for instances of {@code SessionImpl}
* </ul> * </ul>
* <p> * <p>
* This class is not thread-safe.
* This class must appear immutable to clients, even if it does all kinds of caching * This class must appear immutable to clients, even if it does all kinds of caching
* and pooling under the covers. It is crucial that the class is not only thread * and pooling under the covers. It is crucial that the class is not only thread-safe,
* safe, but also highly concurrent. Synchronization must be used extremely sparingly. * but also highly concurrent. Synchronization must be used extremely sparingly.
* *
* @author Gavin King * @author Gavin King
* @author Steve Ebersole * @author Steve Ebersole

View File

@ -165,9 +165,10 @@ import static org.hibernate.proxy.HibernateProxy.extractLazyInitializer;
/** /**
* Concrete implementation of the {@link Session} API. * Concrete implementation of the {@link Session} API.
* <p> * <p>
* Exposes two interfaces:<ul> * Exposes two interfaces:
* <li>{@link Session} to the application</li> * <ul>
* <li>{@link SessionImplementor} and {@link EventSource} to other Hibernate components (SPI)</li> * <li>{@link Session} to the application, and
* <li>{@link SessionImplementor} and {@link EventSource} (both SPI interfaces) to other subsystems.
* </ul> * </ul>
* <p> * <p>
* This class is not thread-safe. * This class is not thread-safe.

View File

@ -47,9 +47,10 @@ import static org.hibernate.proxy.HibernateProxy.extractLazyInitializer;
/** /**
* Concrete implementation of the {@link StatelessSession} API. * Concrete implementation of the {@link StatelessSession} API.
* <p> * <p>
* Exposes two interfaces:<ul> * Exposes two interfaces:
* <li>{@link StatelessSession} to the application</li> * <ul>
* <li>{@link org.hibernate.engine.spi.SharedSessionContractImplementor} to other Hibernate components (SPI)</li> * <li>{@link StatelessSession} to the application, and
* <li>{@link org.hibernate.engine.spi.SharedSessionContractImplementor} (an SPI interface) to other subsystems.
* </ul> * </ul>
* <p> * <p>
* This class is not thread-safe. * This class is not thread-safe.