Package org.hibernate.engine.spi

Interface SharedSessionContractImplementor

All Superinterfaces:

AutoCloseable, JavaType.CoercionContext, JdbcSessionOwner, LobCreationContext, QueryProducer, QueryProducerImplementor, Serializable, SharedSessionContract, TransactionCoordinatorBuilder.Options, WrapperOptions

All Known Subinterfaces:

EventSource, SessionImplementor

All Known Implementing Classes:

AbstractDelegateSessionImplementor, AbstractSharedSessionContract, SessionDelegatorBaseImpl, SessionImpl, SharedSessionDelegatorBaseImpl, StatelessSessionImpl, ToOneDelegateSessionImplementor

public interface SharedSessionContractImplementor
extends SharedSessionContract, JdbcSessionOwner, TransactionCoordinatorBuilder.Options, LobCreationContext, WrapperOptions, QueryProducerImplementor, JavaType.CoercionContext

Defines the internal contract shared between Session and StatelessSession as used by other parts of Hibernate, including implementors of Type, EntityPersister, and CollectionPersister.

The Session, via this interface, implements:

• JdbcSessionOwner, and so the session also acts as the orchestrator of a "JDBC session", and may be used to construct a JdbcCoordinator.
• TransactionCoordinatorBuilder.Options, allowing the session to control the creation of the TransactionCoordinator delegate when it is passed as an argument to TransactionCoordinatorBuilder.buildTransactionCoordinator(org.hibernate.resource.transaction.spi.TransactionCoordinatorOwner, org.hibernate.resource.transaction.spi.TransactionCoordinatorBuilder.Options)
• LobCreationContext, and so the session may act as the context for JDBC LOB instance creation.
• WrapperOptions, and so the session may influence the process of binding and extracting values to and from JDBC, which is performed by implementors of JdbcType.

Nested Class Summary

Nested classes/interfaces inherited from interface org.hibernate.engine.jdbc.LobCreationContext

LobCreationContext.Callback<T>

Method Summary

Modifier and Type	Method	Description
Transaction	accessTransaction()	Retrieves the current Transaction, or creates a new transaction if there is no transaction active.
void	afterOperation(boolean success)	Check if there is a Hibernate or JTA transaction in progress and, if there is not, flush if necessary, making sure that the connection has been committed (if it is not in autocommit mode), and finally run the after completion processing.
void	afterScrollOperation()	Called after each operation on a ScrollableResults, providing an opportunity for a stateless session to clear its temporary persistence context.
default EventSource	asEventSource()	Cast this session to EventSource if possible.
default SessionImplementor	asSessionImplementor()	Deprecated, for removal: This API element is subject to removal in a future version. No longer useful, since Java made downcasting safer
default StatelessSession	asStatelessSession()	Deprecated, for removal: This API element is subject to removal in a future version. No longer useful, since Java made downcasting safer
default boolean	autoFlushIfRequired(Set<String> querySpaces)	detect in-memory changes, determine if the changes are to tables named in the query and, if so, complete execution the flush
boolean	autoFlushIfRequired(Set<String> querySpaces, boolean skipPreFlush)	detect in-memory changes, determine if the changes are to tables named in the query and, if so, complete execution the flush
void	autoPreFlush()
String	bestGuessEntityName(Object object)	Obtain the best estimate of the entity name of the given entity instance, which is not involved in an association, by also considering information held in the proxy, and whether the object is already associated with this session.
default String	bestGuessEntityName(Object object, EntityEntry entry)	Obtain the best estimate of the entity name of the given entity instance, which is not involved in an association, by also considering information held in the proxy, and whether the object is already associated with this session.
default void	checkOpen()	Check whether the session is open, and if not: mark the current transaction, if any, for rollback only, and throw an IllegalStateException.
void	checkOpen(boolean markForRollbackIfClosed)	Check whether the session is open, and if not: if markForRollbackIfClosed = true, mark the current transaction, if any, for rollback only, and throw an IllegalStateException.
default void	checkTransactionNeededForUpdateOperation(String exceptionMessage)	Check if an active Transaction is available before performing an update operation against the database.
<T> RootGraphImplementor<T>	createEntityGraph(Class<T> rootType)	Create a new mutable instance of EntityGraph, with only a root node, allowing programmatic definition of the graph from scratch.
RootGraphImplementor<?>	createEntityGraph(String graphName)	Create a new mutable instance of EntityGraph, based on a predefined named entity graph, allowing customization of the graph, or return null if there is no predefined graph with the given name.
void	flush()	Flush this session.
EntityKey	generateEntityKey(Object id, EntityPersister persister)	Instantiate an EntityKey with the given id and for the entity represented by the given EntityPersister.
CacheTransactionSynchronization	getCacheTransactionSynchronization()	The current CacheTransactionSynchronization associated with this session.
default Integer	getConfiguredJdbcBatchSize()	Get the currently configured JDBC batch size, which might have been specified at either the session or factory level.
Object	getContextEntityIdentifier(Object object)	Return the identifier of the persistent object, or null if it is not associated with this session.
default Dialect	getDialect()	Obtain the Dialect.
RootGraphImplementor<?>	getEntityGraph(String graphName)	Obtain an immutable reference to a predefined named entity graph.
EntityPersister	getEntityPersister(@Nullable String entityName, Object object)	Get the EntityPersister for the given entity instance.
Object	getEntityUsingInterceptor(EntityKey key)	Get the entity instance associated with the given EntityKey, calling the Interceptor if necessary.
SessionEventListenerManager	getEventListenerManager()	Get the SessionEventListenerManager associated with this session.
ExceptionConverter	getExceptionConverter()	Obtain an ExceptionConverter for reporting an error.
SessionFactoryImplementor	getFactory()	Obtain the factory which created this session.
FlushMode	getHibernateFlushMode()	Get the current FlushMode for this session.
Interceptor	getInterceptor()	Retrieves the Interceptor associated with this session.
JdbcCoordinator	getJdbcCoordinator()	Obtain the JdbcCoordinator for this session.
JdbcServices	getJdbcServices()	Obtain the JdbcServices for the factory which created this session.
LoadQueryInfluencers	getLoadQueryInfluencers()	Get the LoadQueryInfluencers associated with this session.
boolean	getNativeJdbcParametersIgnored()
PersistenceContext	getPersistenceContext()	Get the persistence context for this session.
PersistenceContext	getPersistenceContextInternal()	Similar to getPersistenceContext(), with two differences: this version performs better as it allows for inlining and probably better prediction, and it skips some checks of the current state of the session.
default SharedSessionContractImplementor	getSession()	Returns this object, fulfilling the contract of WrapperOptions.
SessionAssociationMarkers	getSessionAssociationMarkers()	Wrap all state that lazy loading interceptors might need to manage association with this session, or to handle lazy loading after detachment via the UUID of the SessionFactory.
default SessionFactoryImplementor	getSessionFactory()	Obtain the factory which created this session.
UUID	getSessionIdentifier()	Obtain a UUID which uniquely identifies this session.
default Object	getSessionToken()	Obtain a "token" which uniquely identifies this session.
default TypeConfiguration	getTypeConfiguration()	Obtain the TypeConfiguration for the factory which created this session.
String	guessEntityName(Object entity)	Obtain an estimate of the entity name of the given entity instance, which is not involved in an association, using only the EntityNameResolver.
Object	immediateLoad(String entityName, Object id)	Load an instance immediately.
void	initializeCollection(PersistentCollection<?> collection, boolean writing)	Initialize the given collection (if not already initialized).
Object	instantiate(String entityName, Object id)	Deprecated, for removal: This API element is subject to removal in a future version. No longer used, replaced by instantiate(EntityPersister, Object)
Object	instantiate(EntityPersister persister, Object id)	Instantiate the entity class of the given EntityPersister, initializing the new instance with the given identifier.
Object	internalLoad(String entityName, Object id, boolean eager, boolean nullable)	Obtain an entity instance with the given id, without checking if it was deleted or scheduled for deletion.
boolean	isClosed()	Determines whether the session is closed.
boolean	isCriteriaCopyTreeEnabled()
boolean	isCriteriaPlanCacheEnabled()
boolean	isDefaultReadOnly()	Are entities and proxies loaded by this session read-only by default?
default boolean	isEventSource()	Determines if this session implements EventSource.
boolean	isIdentifierRollbackEnabled()
default boolean	isOpenOrWaitingForAutoClose()	Determines whether the session is open or is waiting for auto-close.
default boolean	isSessionImplementor()	Deprecated, for removal: This API element is subject to removal in a future version. No longer useful, since Java made downcasting safer
default boolean	isStatelessSession()	Deprecated, for removal: This API element is subject to removal in a future version. No longer useful, since Java made downcasting safer
boolean	isTransactionInProgress()	Does this session have an active Hibernate transaction, or is it associated with a JTA transaction currently in progress?
Object	loadFromSecondLevelCache(EntityPersister persister, EntityKey entityKey, Object instanceToLoad, LockMode lockMode)	Attempts to load the entity from the second-level cache.
void	lock(String entityName, Object child, LockOptions lockOptions)	Cascade the lock operation to the given child entity.
void	markForRollbackOnly()	Marks current transaction, if any, for rollback only.
void	prepareForQueryExecution(boolean requiresTxn)	Prepare for the execution of a Query or ProcedureCall
void	registerProcess(AfterTransactionCompletionProcess process)	Registers the given process for execution after transaction completion.
void	setCriteriaCopyTreeEnabled(boolean jpaCriteriaCopyComplianceEnabled)
void	setCriteriaPlanCacheEnabled(boolean jpaCriteriaCacheEnabled)
void	setNativeJdbcParametersIgnored(boolean nativeJdbcParametersIgnored)

Methods inherited from interface org.hibernate.resource.jdbc.spi.JdbcSessionOwner

afterObtainConnection, afterTransactionBegin, afterTransactionCompletion, beforeReleaseConnection, beforeTransactionCompletion, flushBeforeTransactionCompletion, getEventManager, getEventMonitor, getJdbcBatchSize, getJdbcConnectionAccess, getJdbcSessionContext, getSqlExceptionHelper, getTransactionCoordinator, startTransactionBoundary

Methods inherited from interface org.hibernate.engine.jdbc.LobCreationContext

execute, fromContext

Methods inherited from interface org.hibernate.query.QueryProducer

createMutationQuery, createNamedSelectionQuery, createNamedSelectionQuery, createSelectionQuery, createSelectionQuery, createSelectionQuery, createSelectionQuery

Methods inherited from interface org.hibernate.query.spi.QueryProducerImplementor

createMutationQuery, createMutationQuery, createMutationQuery, createNamedMutationQuery, createNamedQuery, createNamedQuery, createNativeMutationQuery, createNativeQuery, createNativeQuery, createNativeQuery, createNativeQuery, createNativeQuery, createQuery, createQuery, createQuery, createQuery, createQuery, createQuery, getCacheMode, getNamedNativeQuery, getNamedNativeQuery, getNamedQuery

Methods inherited from interface org.hibernate.SharedSessionContract

beginTransaction, close, createEntityGraph, createNamedStoredProcedureQuery, createStoredProcedureCall, createStoredProcedureCall, createStoredProcedureCall, createStoredProcedureQuery, createStoredProcedureQuery, createStoredProcedureQuery, disableFilter, doReturningWork, doWork, enableFilter, fromTransaction, getCacheMode, getCriteriaBuilder, getEnabledFilter, getEntityGraphs, getJdbcBatchSize, getNamedProcedureCall, getTenantIdentifier, getTenantIdentifierValue, getTransaction, inTransaction, isConnected, isJoinedToTransaction, isOpen, joinTransaction, setCacheMode, setJdbcBatchSize, unwrap

Methods inherited from interface org.hibernate.resource.transaction.spi.TransactionCoordinatorBuilder.Options

shouldAutoJoinTransaction

Methods inherited from interface org.hibernate.type.descriptor.WrapperOptions

getJdbcTimeZone, getJsonFormatMapper, getLobCreator, getPreferredSqlTypeCodeForBoolean, getXmlFormatMapper, useStreamForLobBinding

Method Details

getFactory

SessionFactoryImplementor getFactory()

Obtain the factory which created this session.

Specified by:

getFactory in interface QueryProducerImplementor

Specified by:

getFactory in interface SharedSessionContract

getSessionFactory

default SessionFactoryImplementor getSessionFactory()

Obtain the factory which created this session.

Specified by:

getSessionFactory in interface WrapperOptions

getTypeConfiguration

default TypeConfiguration getTypeConfiguration()

Obtain the TypeConfiguration for the factory which created this session.

Specified by:

getTypeConfiguration in interface JavaType.CoercionContext

Specified by:

getTypeConfiguration in interface WrapperOptions

getDialect

default Dialect getDialect()

Obtain the Dialect.

Specified by:

getDialect in interface WrapperOptions

getEventListenerManager

SessionEventListenerManager getEventListenerManager()

Get the SessionEventListenerManager associated with this session.

getPersistenceContext

PersistenceContext getPersistenceContext()

Get the persistence context for this session.

See getPersistenceContextInternal() for a faster alternative.

Implementation Note:

This method is not extremely fast: if you need to call the PersistenceContext multiple times, prefer keeping a reference to it instead of invoking this method multiple times.

getJdbcCoordinator

JdbcCoordinator getJdbcCoordinator()

Obtain the JdbcCoordinator for this session.

getJdbcServices

JdbcServices getJdbcServices()

Obtain the JdbcServices for the factory which created this session.

getSessionIdentifier

UUID getSessionIdentifier()

Obtain a UUID which uniquely identifies this session.

The UUID is useful mainly for logging.

getSession

default SharedSessionContractImplementor getSession()

Returns this object, fulfilling the contract of WrapperOptions.

Specified by:

getSession in interface WrapperOptions

getSessionToken

default Object getSessionToken()

Obtain a "token" which uniquely identifies this session.

isClosed

boolean isClosed()

Determines whether the session is closed.

Returns:

true if the session is closed; false otherwise.

API Note:

Provided separately from SharedSessionContract.isOpen() as this method does not attempt any JTA synchronization registration, whereas SharedSessionContract.isOpen() does. This one is better for most internal purposes.

isOpenOrWaitingForAutoClose

default boolean isOpenOrWaitingForAutoClose()

Determines whether the session is open or is waiting for auto-close.

Returns:

true if the session is closed, or if it's waiting for auto-close; false otherwise.

checkOpen

default void checkOpen()

Check whether the session is open, and if not:

• mark the current transaction, if any, for rollback only, and
• throw an IllegalStateException. (JPA specifies this exception type.)

checkOpen

void checkOpen(boolean markForRollbackIfClosed)

Check whether the session is open, and if not:

• if markForRollbackIfClosed = true, mark the current transaction, if any, for rollback only, and
• throw an IllegalStateException. (JPA specifies this exception type.)

prepareForQueryExecution

void prepareForQueryExecution(boolean requiresTxn)

Prepare for the execution of a Query or ProcedureCall

markForRollbackOnly

void markForRollbackOnly()

Marks current transaction, if any, for rollback only.

getCacheTransactionSynchronization

CacheTransactionSynchronization getCacheTransactionSynchronization()

The current CacheTransactionSynchronization associated with this session. This may be null if the session is not currently associated with an active transaction.

isTransactionInProgress

boolean isTransactionInProgress()

Does this session have an active Hibernate transaction, or is it associated with a JTA transaction currently in progress?

checkTransactionNeededForUpdateOperation

default void checkTransactionNeededForUpdateOperation(String exceptionMessage)

Check if an active Transaction is available before performing an update operation against the database.

If an active transaction is necessary, but no transaction is active, a TransactionRequiredException is raised.

Parameters:

exceptionMessage - the message to use for the TransactionRequiredException

accessTransaction

Transaction accessTransaction()

Retrieves the current Transaction, or creates a new transaction if there is no transaction active.

This method is primarily for internal or integrator use.

Returns:

the Transaction

generateEntityKey

EntityKey generateEntityKey(Object id,
 EntityPersister persister)

Instantiate an EntityKey with the given id and for the entity represented by the given EntityPersister.

Parameters:

id - The entity id

persister - The entity persister

Returns:

The entity key

getInterceptor

Interceptor getInterceptor()

Retrieves the Interceptor associated with this session.

initializeCollection

void initializeCollection(PersistentCollection<?> collection,
 boolean writing)
                   throws HibernateException

Initialize the given collection (if not already initialized).

Throws:

HibernateException

internalLoad

Object internalLoad(String entityName,
 Object id,
 boolean eager,
 boolean nullable)
             throws HibernateException

Obtain an entity instance with the given id, without checking if it was deleted or scheduled for deletion.

• When nullable = false, this method may create a new proxy or return an existing proxy; if it does not exist, an exception is thrown.
• When nullable = true, the method does not create new proxies, though it might return an existing proxy; if it does not exist, a null value is returned.

When eager = true, the object is eagerly fetched from the database.

Throws:

HibernateException

immediateLoad

Object immediateLoad(String entityName,
 Object id)
              throws HibernateException

Load an instance immediately. This method is only called when lazily initializing a proxy. Do not return the proxy.

Throws:

HibernateException

getEntityPersister

EntityPersister getEntityPersister(@Nullable String entityName,
 Object object)
                            throws HibernateException

Get the EntityPersister for the given entity instance.

Parameters:

entityName - optional entity name

object - the entity instance

Throws:

HibernateException

getEntityUsingInterceptor

Object getEntityUsingInterceptor(EntityKey key)
                          throws HibernateException

Get the entity instance associated with the given EntityKey, calling the Interceptor if necessary.

Throws:

HibernateException

getContextEntityIdentifier

Object getContextEntityIdentifier(Object object)

Return the identifier of the persistent object, or null if it is not associated with this session.

bestGuessEntityName

String bestGuessEntityName(Object object)

Obtain the best estimate of the entity name of the given entity instance, which is not involved in an association, by also considering information held in the proxy, and whether the object is already associated with this session.

bestGuessEntityName

default String bestGuessEntityName(Object object,
 EntityEntry entry)

Obtain the best estimate of the entity name of the given entity instance, which is not involved in an association, by also considering information held in the proxy, and whether the object is already associated with this session.

guessEntityName

String guessEntityName(Object entity)
                throws HibernateException

Obtain an estimate of the entity name of the given entity instance, which is not involved in an association, using only the EntityNameResolver.

Throws:

HibernateException

instantiate

@Deprecated(since="7",
            forRemoval=true)
Object instantiate(String entityName,
 Object id)
            throws HibernateException

Deprecated, for removal: This API element is subject to removal in a future version.

No longer used, replaced by instantiate(EntityPersister, Object)

Instantiate the entity class, initializing with the given identifier.

Throws:

HibernateException

instantiate

Object instantiate(EntityPersister persister,
 Object id)
            throws HibernateException

Instantiate the entity class of the given EntityPersister, initializing the new instance with the given identifier.

This is more efficient than instantiate(String, Object), but not always interchangeable, since a single persister might be responsible for multiple types.

Throws:

HibernateException

isDefaultReadOnly

boolean isDefaultReadOnly()

Are entities and proxies loaded by this session read-only by default?

isIdentifierRollbackEnabled

boolean isIdentifierRollbackEnabled()

setCriteriaCopyTreeEnabled

void setCriteriaCopyTreeEnabled(boolean jpaCriteriaCopyComplianceEnabled)

isCriteriaCopyTreeEnabled

boolean isCriteriaCopyTreeEnabled()

setCriteriaPlanCacheEnabled

void setCriteriaPlanCacheEnabled(boolean jpaCriteriaCacheEnabled)

isCriteriaPlanCacheEnabled

boolean isCriteriaPlanCacheEnabled()

getNativeJdbcParametersIgnored

boolean getNativeJdbcParametersIgnored()

setNativeJdbcParametersIgnored

void setNativeJdbcParametersIgnored(boolean nativeJdbcParametersIgnored)

getHibernateFlushMode

FlushMode getHibernateFlushMode()

Get the current FlushMode for this session.

Specified by:

getHibernateFlushMode in interface QueryProducerImplementor

Returns:

The flush mode

flush

void flush()

Flush this session.

isEventSource

default boolean isEventSource()

Determines if this session implements EventSource.

Only stateful session are sources of events. If this object is a stateless session, this method return false.

asEventSource

default EventSource asEventSource()

Cast this session to EventSource if possible.

Only stateful session are sources of events. If this object is a stateless session, this method throws.

Throws:

ClassCastException - if the cast is not possible

afterScrollOperation

void afterScrollOperation()

Called after each operation on a ScrollableResults, providing an opportunity for a stateless session to clear its temporary persistence context. For a stateful session, this method does nothing.

getLoadQueryInfluencers

LoadQueryInfluencers getLoadQueryInfluencers()

Get the LoadQueryInfluencers associated with this session.

Returns:

the LoadQueryInfluencers associated with this session; should never be null.

getExceptionConverter

ExceptionConverter getExceptionConverter()

Obtain an ExceptionConverter for reporting an error.

The converter associated to a session might be lazily initialized, so only invoke this getter when there's an actual need to use it.

Returns:

the ExceptionConverter for this Session.

getConfiguredJdbcBatchSize

default Integer getConfiguredJdbcBatchSize()

Get the currently configured JDBC batch size, which might have been specified at either the session or factory level.

Returns:

the session-level JDBC batch size is set, or the factory-level setting otherwise

Since:

5.2

See Also:

• SessionFactoryOptions.getJdbcBatchSize()
• SessionFactoryBuilder.applyJdbcBatchSize(int)

getPersistenceContextInternal

PersistenceContext getPersistenceContextInternal()

Similar to getPersistenceContext(), with two differences:

1. this version performs better as it allows for inlining and probably better prediction, and
2. it skips some checks of the current state of the session.

Choose wisely: performance is important, but correctness comes first.

Returns:

the PersistenceContext associated to this session.

autoFlushIfRequired

default boolean autoFlushIfRequired(Set<String> querySpaces)

detect in-memory changes, determine if the changes are to tables named in the query and, if so, complete execution the flush

Parameters:

querySpaces - the tables named in the query.

Returns:

true if flush is required, false otherwise.

autoFlushIfRequired

boolean autoFlushIfRequired(Set<String> querySpaces,
 boolean skipPreFlush)

detect in-memory changes, determine if the changes are to tables named in the query and, if so, complete execution the flush

Parameters:

querySpaces - the tables named in the query.

skipPreFlush - see AutoFlushEvent.isSkipPreFlush()

Returns:

true if flush is required, false otherwise.

autoPreFlush

void autoPreFlush()

afterOperation

void afterOperation(boolean success)

Check if there is a Hibernate or JTA transaction in progress and, if there is not, flush if necessary, making sure that the connection has been committed (if it is not in autocommit mode), and finally run the after completion processing.

Parameters:

success - true if the operation a success

asSessionImplementor

@Deprecated(since="7.0",
            forRemoval=true)
default SessionImplementor asSessionImplementor()

Deprecated, for removal: This API element is subject to removal in a future version.

No longer useful, since Java made downcasting safer

Cast this object to SessionImplementor, if possible.

Throws:

ClassCastException - if the cast is not possible

isSessionImplementor

@Deprecated(since="7.0",
            forRemoval=true)
default boolean isSessionImplementor()

Deprecated, for removal: This API element is subject to removal in a future version.

No longer useful, since Java made downcasting safer

Does this object implement SessionImplementor?

asStatelessSession

@Deprecated(since="7.0",
            forRemoval=true)
default StatelessSession asStatelessSession()

Deprecated, for removal: This API element is subject to removal in a future version.

No longer useful, since Java made downcasting safer

Cast this object to StatelessSession, if possible.

Throws:

ClassCastException - if the cast is not possible

isStatelessSession

@Deprecated(since="7.0",
            forRemoval=true)
default boolean isStatelessSession()

Deprecated, for removal: This API element is subject to removal in a future version.

No longer useful, since Java made downcasting safer

Does this object implement StatelessSession?

lock

void lock(String entityName,
 Object child,
 LockOptions lockOptions)

Cascade the lock operation to the given child entity.

registerProcess

@Incubating
void registerProcess(AfterTransactionCompletionProcess process)

Registers the given process for execution after transaction completion.

Parameters:

process - The process to register

Since:

7.0

loadFromSecondLevelCache

@Incubating
Object loadFromSecondLevelCache(EntityPersister persister,
 EntityKey entityKey,
 Object instanceToLoad,
 LockMode lockMode)

Attempts to load the entity from the second-level cache.

Parameters:

persister - The persister for the entity being requested for load

entityKey - The entity key

instanceToLoad - The instance that is being initialized, or null

lockMode - The lock mode

Returns:

The entity from the second-level cache, or null.

Since:

7.0

getSessionAssociationMarkers

@Incubating
SessionAssociationMarkers getSessionAssociationMarkers()

Wrap all state that lazy loading interceptors might need to manage association with this session, or to handle lazy loading after detachment via the UUID of the SessionFactory. N.B. this captures the current Session, however it can get updated to a null session (for detached entities) or updated to a different Session.

createEntityGraph

<T> RootGraphImplementor<T> createEntityGraph(Class<T> rootType)

Description copied from interface: SharedSessionContract

Create a new mutable instance of EntityGraph, with only a root node, allowing programmatic definition of the graph from scratch.

Specified by:

createEntityGraph in interface SharedSessionContract

Parameters:

rootType - the root entity class of the graph

See Also:

• EntityGraphs.createGraph(jakarta.persistence.metamodel.EntityType)

createEntityGraph

RootGraphImplementor<?> createEntityGraph(String graphName)

Description copied from interface: SharedSessionContract

Create a new mutable instance of EntityGraph, based on a predefined named entity graph, allowing customization of the graph, or return null if there is no predefined graph with the given name.

Specified by:

createEntityGraph in interface SharedSessionContract

Parameters:

graphName - the name of the graph

See Also:

• EntityManagerFactory.getNamedEntityGraphs(Class)
• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)

getEntityGraph

RootGraphImplementor<?> getEntityGraph(String graphName)

Description copied from interface: SharedSessionContract

Obtain an immutable reference to a predefined named entity graph.

Specified by:

getEntityGraph in interface SharedSessionContract

Parameters:

graphName - the name of the predefined named entity graph

See Also:

• EntityManager.getEntityGraph(String)
• EntityManagerFactory.getNamedEntityGraphs(Class)
• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)