Package org.hibernate.engine.spi

Class SessionFactoryDelegatingImpl

java.lang.Object

org.hibernate.engine.spi.SessionFactoryDelegatingImpl

All Implemented Interfaces:

EntityManagerFactory, Serializable, AutoCloseable, Referenceable, SessionFactoryImplementor, BindingContext, QueryParameterBindingTypeResolver, SqmCreationContext, SessionFactory, SqlAstCreationContext, MappingContext

public class SessionFactoryDelegatingImpl
extends Object
implements SessionFactoryImplementor, SessionFactory

Base delegating implementation of the SessionFactory and SessionFactoryImplementor contracts for intended for easier implementation of SessionFactory.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
SessionFactoryDelegatingImpl(SessionFactoryImplementor delegate)

Method Summary

Modifier and Type	Method	Description
<T> void	addNamedEntityGraph(String graphName, EntityGraph<T> entityGraph)
void	addNamedQuery(String name, Query query)
void	addObserver(SessionFactoryObserver observer)
String	bestGuessEntityName(Object object)	The best guess entity name for an entity not in an association
<R> R	callInTransaction(Function<EntityManager,R> work)
Class<?>	classForName(String className)
void	close()	Destroy this SessionFactory and release all its resources, including caches and connection pools.
boolean	containsFetchProfileDefinition(String name)	Determine if there is a fetch profile definition registered under the given name.
Session	createEntityManager()	Create a new Session.
Session	createEntityManager(SynchronizationType synchronizationType)	Create a new Session, with the given synchronization type.
Session	createEntityManager(SynchronizationType synchronizationType, Map map)	Create a new Session, with the given synchronization type and properties.
Session	createEntityManager(Map map)	Create a new Session, with the given properties.
protected SessionFactoryImplementor	delegate()
RootGraphImplementor<?>	findEntityGraphByName(String name)	Return the root EntityGraph with the given name, or null if there is no graph with the given name.
<T> List<EntityGraph<? super T>>	findEntityGraphsByType(Class<T> entityClass)	Return all EntityGraphs registered for the given entity type.
Collection<FilterDefinition>	getAutoEnabledFilters()
CacheImplementor	getCache()	Obtain direct access to the underlying cache regions.
Set<String>	getCollectionRolesByEntityParticipant(String entityName)	Deprecated.
HibernateCriteriaBuilder	getCriteriaBuilder()	Obtain a HibernateCriteriaBuilder which may be used to construct criteria queries.
Session	getCurrentSession()	Obtains the current session, an instance of Session implicitly associated with some context or scope.
CurrentTenantIdentifierResolver<Object>	getCurrentTenantIdentifierResolver()
CustomEntityDirtinessStrategy	getCustomEntityDirtinessStrategy()
Set<String>	getDefinedFetchProfileNames()	Obtain the set of names of all defined fetch profiles.
Set<String>	getDefinedFilterNames()	Obtain the set of names of all defined filters.
EntityNotFoundDelegate	getEntityNotFoundDelegate()
EventEngine	getEventEngine()	Get the EventEngine associated with this SessionFactory
FastSessionServices	getFastSessionServices()
FetchProfile	getFetchProfile(String name)	Retrieve fetch profile by name.
FilterDefinition	getFilterDefinition(String filterName)	Deprecated.
Generator	getGenerator(String rootEntityName)	Deprecated.
String	getIdentifierPropertyName(String className)
Type	getIdentifierType(String className)
JdbcServices	getJdbcServices()
String	getJndiName()	The JNDI name, used to bind the SessionFactory to JNDI.
JpaMetamodel	getJpaMetamodel()
Integer	getMaximumFetchDepth()	When creating Fetch references, defines a limit to how deep we should join for fetches.
MappingMetamodel	getMetamodel()	Deprecated.
String	getName()	Access to the name (if one) assigned to the SessionFactory
<E> Map<String,EntityGraph<? extends E>>	getNamedEntityGraphs(Class<E> entityType)
<R> Map<String,TypedQueryReference<R>>	getNamedQueries(Class<R> resultType)
PersistenceUnitUtil	getPersistenceUnitUtil()
Map<String,Object>	getProperties()
QueryEngine	getQueryEngine()
Reference	getReference()
Type	getReferencedPropertyType(String className, String propertyName)
RuntimeMetamodelsImplementor	getRuntimeMetamodels()
SchemaManager	getSchemaManager()	A SchemaManager with the same default catalog and schema as pooled connections belonging to this factory.
ServiceRegistryImplementor	getServiceRegistry()	Access to the ServiceRegistry for this SessionFactory.
SessionFactoryOptions	getSessionFactoryOptions()	Get the options used to build this factory.
SqlStringGenerationContext	getSqlStringGenerationContext()
StatisticsImplementor	getStatistics()	Retrieve the statistics for this factory.
JavaType<Object>	getTenantIdentifierJavaType()	The java type to use for a tenant identifier.
PersistenceUnitTransactionType	getTransactionType()
TypeConfiguration	getTypeConfiguration()
String	getUuid()	Get the UUID for this SessionFactory.
WrapperOptions	getWrapperOptions()	Return an instance of WrapperOptions which is not backed by a session, and whose functionality is therefore incomplete.
boolean	isClosed()	Is this factory already closed?
boolean	isOpen()
SessionImplementor	openSession()	Overrides SessionFactory.openSession() to widen the return type: this is useful for internal code depending on SessionFactoryImplementor as it would otherwise need to frequently resort to casting to the internal contract.
StatelessSession	openStatelessSession()	Open a new stateless session.
StatelessSession	openStatelessSession(Connection connection)	Open a new stateless session, utilizing the specified JDBC Connection.
SessionImplementor	openTemporarySession()	Get a non-transactional "current" session (used by hibernate-envers)
<T> BindableType<T>	resolveParameterBindType(Class<T> clazz)	Deprecated.
<T> BindableType<? super T>	resolveParameterBindType(T bindValue)	Deprecated.
void	runInTransaction(Consumer<EntityManager> work)
<T> T	unwrap(Class<T> cls)
SessionBuilderImplementor	withOptions()	Obtain a session builder for creating new Sessions with certain customized options.
StatelessSessionBuilder	withStatelessOptions()	Obtain a StatelessSession builder.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.hibernate.SessionFactory

fromSession, fromStatelessSession, fromStatelessTransaction, fromTransaction, inSession, inStatelessSession, inStatelessTransaction, inTransaction

Methods inherited from interface org.hibernate.engine.spi.SessionFactoryImplementor

getMappingMetamodel, getSessionFactory

Methods inherited from interface org.hibernate.query.sqm.spi.SqmCreationContext

getNodeBuilder

Constructor Details

SessionFactoryDelegatingImpl

public SessionFactoryDelegatingImpl(SessionFactoryImplementor delegate)

Method Details

delegate

protected SessionFactoryImplementor delegate()

getSessionFactoryOptions

public SessionFactoryOptions getSessionFactoryOptions()

Description copied from interface: SessionFactory

Get the options used to build this factory.

Specified by:

getSessionFactoryOptions in interface SessionFactory

Specified by:

getSessionFactoryOptions in interface SessionFactoryImplementor

Returns:

The special options used to build the factory.

withOptions

public SessionBuilderImplementor withOptions()

Description copied from interface: SessionFactory

Obtain a session builder for creating new Sessions with certain customized options.

Specified by:

withOptions in interface SessionFactory

Specified by:

withOptions in interface SessionFactoryImplementor

Returns:

The session builder

openSession

public SessionImplementor openSession()
                               throws HibernateException

Description copied from interface: SessionFactoryImplementor

Overrides SessionFactory.openSession() to widen the return type: this is useful for internal code depending on SessionFactoryImplementor as it would otherwise need to frequently resort to casting to the internal contract.

Specified by:

openSession in interface SessionFactory

Specified by:

openSession in interface SessionFactoryImplementor

Returns:

the opened Session.

Throws:

HibernateException - Indicates a problem opening the session; pretty rare here.

getCurrentSession

public Session getCurrentSession()
                          throws HibernateException

Description copied from interface: SessionFactory

Obtains the current session, an instance of Session implicitly associated with some context or scope. For example, the session might be associated with the current thread, or with the current JTA transaction.

The context used for scoping the current session (that is, the definition of what precisely "current" means here) is determined by an implementation of CurrentSessionContext. An implementation may be selected using the configuration property "hibernate.current_session_context_class".

If no CurrentSessionContext is explicitly configured, but JTA support is enabled, then JTASessionContext is used, and the current session is scoped to the active JTA transaction.

Specified by:

getCurrentSession in interface SessionFactory

Returns:

The current session.

Throws:

HibernateException - Indicates an issue locating a suitable current session.

See Also:

• CurrentSessionContext
• AvailableSettings.CURRENT_SESSION_CONTEXT_CLASS

withStatelessOptions

public StatelessSessionBuilder withStatelessOptions()

Description copied from interface: SessionFactory

Obtain a StatelessSession builder.

Specified by:

withStatelessOptions in interface SessionFactory

Returns:

The stateless session builder

openStatelessSession

public StatelessSession openStatelessSession()

Description copied from interface: SessionFactory

Open a new stateless session.

Specified by:

openStatelessSession in interface SessionFactory

Returns:

The new stateless session.

openStatelessSession

public StatelessSession openStatelessSession(Connection connection)

Description copied from interface: SessionFactory

Open a new stateless session, utilizing the specified JDBC Connection.

Specified by:

openStatelessSession in interface SessionFactory

Parameters:

connection - Connection provided by the application.

Returns:

The new stateless session.

getStatistics

public StatisticsImplementor getStatistics()

Description copied from interface: SessionFactory

Retrieve the statistics for this factory.

Specified by:

getStatistics in interface SessionFactory

Specified by:

getStatistics in interface SessionFactoryImplementor

Returns:

The statistics.

getSchemaManager

public SchemaManager getSchemaManager()

Description copied from interface: SessionFactory

A SchemaManager with the same default catalog and schema as pooled connections belonging to this factory. Intended mostly as a convenience for writing tests.

Specified by:

getSchemaManager in interface EntityManagerFactory

Specified by:

getSchemaManager in interface SessionFactory

getRuntimeMetamodels

public RuntimeMetamodelsImplementor getRuntimeMetamodels()

Specified by:

getRuntimeMetamodels in interface SessionFactoryImplementor

getEventEngine

public EventEngine getEventEngine()

Description copied from interface: SessionFactoryImplementor

Get the EventEngine associated with this SessionFactory

Specified by:

getEventEngine in interface SessionFactoryImplementor

close

public void close()
           throws HibernateException

Description copied from interface: SessionFactory

Destroy this SessionFactory and release all its resources, including caches and connection pools.

It is the responsibility of the application to ensure that there are no open sessions before calling this method as the impact on those sessions is indeterminate.

No-ops if already closed.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface EntityManagerFactory

Specified by:

close in interface SessionFactory

Throws:

HibernateException - Indicates an issue closing the factory.

isClosed

public boolean isClosed()

Description copied from interface: SessionFactory

Is this factory already closed?

Specified by:

isClosed in interface SessionFactory

Returns:

True if this factory is already closed; false otherwise.

getCache

public CacheImplementor getCache()

Description copied from interface: SessionFactory

Obtain direct access to the underlying cache regions.

Specified by:

getCache in interface EntityManagerFactory

Specified by:

getCache in interface SessionFactory

Specified by:

getCache in interface SessionFactoryImplementor

Returns:

The direct cache access API.

getPersistenceUnitUtil

public PersistenceUnitUtil getPersistenceUnitUtil()

Specified by:

getPersistenceUnitUtil in interface EntityManagerFactory

getTransactionType

public PersistenceUnitTransactionType getTransactionType()

Specified by:

getTransactionType in interface EntityManagerFactory

addNamedQuery

public void addNamedQuery(String name,
 Query query)

Specified by:

addNamedQuery in interface EntityManagerFactory

unwrap

public <T> T unwrap(Class<T> cls)

Specified by:

unwrap in interface EntityManagerFactory

addNamedEntityGraph

public <T> void addNamedEntityGraph(String graphName,
 EntityGraph<T> entityGraph)

Specified by:

addNamedEntityGraph in interface EntityManagerFactory

runInTransaction

public void runInTransaction(Consumer<EntityManager> work)

Specified by:

runInTransaction in interface EntityManagerFactory

callInTransaction

public <R> R callInTransaction(Function<EntityManager,R> work)

Specified by:

callInTransaction in interface EntityManagerFactory

getDefinedFilterNames

public Set<String> getDefinedFilterNames()

Description copied from interface: SessionFactory

Obtain the set of names of all defined filters.

Specified by:

getDefinedFilterNames in interface SessionFactory

Returns:

The set of filter names given by FilterDef annotations

getFilterDefinition

@Deprecated
public FilterDefinition getFilterDefinition(String filterName)
                                     throws HibernateException

Deprecated.

Description copied from interface: SessionFactory

Obtain the definition of a filter by name.

Specified by:

getFilterDefinition in interface SessionFactory

Specified by:

getFilterDefinition in interface SessionFactoryImplementor

Parameters:

filterName - The name of the filter for which to obtain the definition.

Returns:

The filter definition.

Throws:

HibernateException - If no filter defined with the given name.

getAutoEnabledFilters

public Collection<FilterDefinition> getAutoEnabledFilters()

Specified by:

getAutoEnabledFilters in interface SessionFactoryImplementor

containsFetchProfileDefinition

public boolean containsFetchProfileDefinition(String name)

Description copied from interface: SessionFactory

Determine if there is a fetch profile definition registered under the given name.

Specified by:

containsFetchProfileDefinition in interface SessionFactory

Parameters:

name - The name to check

Returns:

True if there is such a fetch profile; false otherwise.

getDefinedFetchProfileNames

public Set<String> getDefinedFetchProfileNames()

Description copied from interface: SessionFactory

Obtain the set of names of all defined fetch profiles.

Specified by:

getDefinedFetchProfileNames in interface SessionFactory

Returns:

The set of fetch profile names given by FetchProfile annotations.

getGenerator

@Deprecated
public Generator getGenerator(String rootEntityName)

Deprecated.

Description copied from interface: SessionFactoryImplementor

Get the identifier generator for the hierarchy

Specified by:

getGenerator in interface SessionFactoryImplementor

getProperties

public Map<String,Object> getProperties()

Specified by:

getProperties in interface EntityManagerFactory

getJdbcServices

public JdbcServices getJdbcServices()

Specified by:

getJdbcServices in interface SessionFactoryImplementor

getSqlStringGenerationContext

public SqlStringGenerationContext getSqlStringGenerationContext()

Specified by:

getSqlStringGenerationContext in interface SessionFactoryImplementor

findEntityGraphByName

public RootGraphImplementor<?> findEntityGraphByName(String name)

Description copied from interface: SessionFactory

Return the root EntityGraph with the given name, or null if there is no graph with the given name.

Specified by:

findEntityGraphByName in interface SessionFactory

Specified by:

findEntityGraphByName in interface SessionFactoryImplementor

Parameters:

name - the name given to some NamedEntityGraph

Returns:

an instance of RootGraph

See Also:

• EntityManagerFactory.addNamedEntityGraph(java.lang.String, jakarta.persistence.EntityGraph<T>)

getNamedQueries

public <R> Map<String,TypedQueryReference<R>> getNamedQueries(Class<R> resultType)

Specified by:

getNamedQueries in interface EntityManagerFactory

getNamedEntityGraphs

public <E> Map<String,EntityGraph<? extends E>> getNamedEntityGraphs(Class<E> entityType)

Specified by:

getNamedEntityGraphs in interface EntityManagerFactory

bestGuessEntityName

public String bestGuessEntityName(Object object)

Description copied from interface: SessionFactoryImplementor

The best guess entity name for an entity not in an association

Specified by:

bestGuessEntityName in interface SessionFactoryImplementor

openTemporarySession

public SessionImplementor openTemporarySession()
                                        throws HibernateException

Description copied from interface: SessionFactoryImplementor

Get a non-transactional "current" session (used by hibernate-envers)

Specified by:

openTemporarySession in interface SessionFactoryImplementor

Throws:

HibernateException

getCollectionRolesByEntityParticipant

@Deprecated
public Set<String> getCollectionRolesByEntityParticipant(String entityName)

Deprecated.

getEntityNotFoundDelegate

public EntityNotFoundDelegate getEntityNotFoundDelegate()

Specified by:

getEntityNotFoundDelegate in interface SessionFactoryImplementor

getFetchProfile

public FetchProfile getFetchProfile(String name)

Description copied from interface: SessionFactoryImplementor

Retrieve fetch profile by name.

Specified by:

getFetchProfile in interface SessionFactoryImplementor

Parameters:

name - The name of the profile to retrieve.

Returns:

The profile definition

getJpaMetamodel

public JpaMetamodel getJpaMetamodel()

Specified by:

getJpaMetamodel in interface BindingContext

getServiceRegistry

public ServiceRegistryImplementor getServiceRegistry()

Description copied from interface: SessionFactoryImplementor

Access to the ServiceRegistry for this SessionFactory.

Specified by:

getServiceRegistry in interface SessionFactoryImplementor

Returns:

The factory's ServiceRegistry

getMaximumFetchDepth

public Integer getMaximumFetchDepth()

Description copied from interface: SqlAstCreationContext

When creating Fetch references, defines a limit to how deep we should join for fetches.

Specified by:

getMaximumFetchDepth in interface SqlAstCreationContext

addObserver

public void addObserver(SessionFactoryObserver observer)

Specified by:

addObserver in interface SessionFactoryImplementor

getCustomEntityDirtinessStrategy

public CustomEntityDirtinessStrategy getCustomEntityDirtinessStrategy()

Specified by:

getCustomEntityDirtinessStrategy in interface SessionFactoryImplementor

getCurrentTenantIdentifierResolver

public CurrentTenantIdentifierResolver<Object> getCurrentTenantIdentifierResolver()

Specified by:

getCurrentTenantIdentifierResolver in interface SessionFactoryImplementor

getTenantIdentifierJavaType

public JavaType<Object> getTenantIdentifierJavaType()

Description copied from interface: SessionFactoryImplementor

The java type to use for a tenant identifier.

Specified by:

getTenantIdentifierJavaType in interface SessionFactoryImplementor

getFastSessionServices

public FastSessionServices getFastSessionServices()

Specified by:

getFastSessionServices in interface SessionFactoryImplementor

Returns:

the FastSessionServices instance associated with this factory

getIdentifierType

public Type getIdentifierType(String className)
                       throws MappingException

Specified by:

getIdentifierType in interface MappingContext

Throws:

MappingException

getIdentifierPropertyName

public String getIdentifierPropertyName(String className)
                                 throws MappingException

Specified by:

getIdentifierPropertyName in interface MappingContext

Throws:

MappingException

getReferencedPropertyType

public Type getReferencedPropertyType(String className,
 String propertyName)
                               throws MappingException

Specified by:

getReferencedPropertyType in interface MappingContext

Throws:

MappingException

getUuid

public String getUuid()

Description copied from interface: SessionFactoryImplementor

Get the UUID for this SessionFactory.

The value is generated as a UUID, but kept as a String.

Specified by:

getUuid in interface SessionFactoryImplementor

Returns:

The UUID for this SessionFactory.

See Also:

• SessionFactoryRegistry.getSessionFactory(java.lang.String)

getName

public String getName()

Description copied from interface: SessionFactoryImplementor

Access to the name (if one) assigned to the SessionFactory

Specified by:

getName in interface EntityManagerFactory

Specified by:

getName in interface SessionFactoryImplementor

Returns:

The name for the SessionFactory

getJndiName

public String getJndiName()

Description copied from interface: SessionFactory

The JNDI name, used to bind the SessionFactory to JNDI.

Specified by:

getJndiName in interface SessionFactory

getTypeConfiguration

public TypeConfiguration getTypeConfiguration()

Specified by:

getTypeConfiguration in interface BindingContext

Specified by:

getTypeConfiguration in interface QueryParameterBindingTypeResolver

Specified by:

getTypeConfiguration in interface SessionFactoryImplementor

getQueryEngine

public QueryEngine getQueryEngine()

Specified by:

getQueryEngine in interface SqmCreationContext

getReference

public Reference getReference()
                       throws NamingException

Specified by:

getReference in interface Referenceable

Throws:

NamingException

createEntityManager

public Session createEntityManager()

Description copied from interface: SessionFactory

Create a new Session.

Specified by:

createEntityManager in interface EntityManagerFactory

Specified by:

createEntityManager in interface SessionFactory

createEntityManager

public Session createEntityManager(Map map)

Description copied from interface: SessionFactory

Create a new Session, with the given properties.

Specified by:

createEntityManager in interface EntityManagerFactory

Specified by:

createEntityManager in interface SessionFactory

createEntityManager

public Session createEntityManager(SynchronizationType synchronizationType)

Description copied from interface: SessionFactory

Create a new Session, with the given synchronization type.

Specified by:

createEntityManager in interface EntityManagerFactory

Specified by:

createEntityManager in interface SessionFactory

createEntityManager

public Session createEntityManager(SynchronizationType synchronizationType,
 Map map)

Description copied from interface: SessionFactory

Create a new Session, with the given synchronization type and properties.

Specified by:

createEntityManager in interface EntityManagerFactory

Specified by:

createEntityManager in interface SessionFactory

getCriteriaBuilder

public HibernateCriteriaBuilder getCriteriaBuilder()

Description copied from interface: SessionFactory

Obtain a HibernateCriteriaBuilder which may be used to construct criteria queries.

Specified by:

getCriteriaBuilder in interface EntityManagerFactory

Specified by:

getCriteriaBuilder in interface SessionFactory

See Also:

• SharedSessionContract.getCriteriaBuilder()

getMetamodel

@Deprecated
public MappingMetamodel getMetamodel()

Deprecated.

Specified by:

getMetamodel in interface EntityManagerFactory

isOpen

public boolean isOpen()

Specified by:

isOpen in interface EntityManagerFactory

resolveParameterBindType

@Deprecated
public <T> BindableType<? super T> resolveParameterBindType(T bindValue)

Deprecated.

Specified by:

resolveParameterBindType in interface QueryParameterBindingTypeResolver

resolveParameterBindType

@Deprecated
public <T> BindableType<T> resolveParameterBindType(Class<T> clazz)

Deprecated.

Specified by:

resolveParameterBindType in interface QueryParameterBindingTypeResolver

getWrapperOptions

public WrapperOptions getWrapperOptions()

Description copied from interface: SessionFactoryImplementor

Return an instance of WrapperOptions which is not backed by a session, and whose functionality is therefore incomplete.

Specified by:

getWrapperOptions in interface SessionFactoryImplementor

findEntityGraphsByType

public <T> List<EntityGraph<? super T>> findEntityGraphsByType(Class<T> entityClass)

Description copied from interface: SessionFactory

Return all EntityGraphs registered for the given entity type.

Specified by:

findEntityGraphsByType in interface SessionFactory

See Also:

• EntityManagerFactory.addNamedEntityGraph(java.lang.String, jakarta.persistence.EntityGraph<T>)

classForName

public Class<?> classForName(String className)

Specified by:

classForName in interface SqmCreationContext