Package org.hibernate.engine.spi

Class SessionDelegatorBaseImpl

java.lang.Object

org.hibernate.engine.spi.SessionDelegatorBaseImpl

All Implemented Interfaces:

EntityManager, Closeable, Serializable, AutoCloseable, LobCreationContext, SessionImplementor, SharedSessionContractImplementor, QueryProducer, QueryProducerImplementor, JdbcSessionOwner, TransactionCoordinatorBuilder.Options, Session, SharedSessionContract, JavaType.CoercionContext, WrapperOptions

Direct Known Subclasses:

AbstractDelegateSessionImplementor

public class SessionDelegatorBaseImpl
extends Object
implements SessionImplementor

A wrapper class that delegates all method invocations to a delegate instance of SessionImplementor. This is useful for custom implementations of that API, so that only some methods need to be overridden

(Used by Hibernate Search).

Author:

Sanne Grinovero

See Also:

• Serialized Form

Nested Class Summary

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

LobCreationContext.Callback<T>

Nested classes/interfaces inherited from interface org.hibernate.Session

Session.LockRequest

Field Summary

Fields

Modifier and Type	Field	Description
protected final SessionImplementor	delegate

Constructor Summary

Constructors

Constructor	Description
SessionDelegatorBaseImpl(SessionImplementor delegate)

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	addEventListeners(SessionEventListener... listeners)	Add one or more listeners to the Session
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.
void	afterTransactionBegin()	A after-begin callback from the coordinator to its owner.
void	afterTransactionCompletion(boolean successful, boolean delayed)	An after-completion callback to the owner.
EventSource	asEventSource()	Cast this session to EventSource if possible.
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)
void	autoPreFlush()
void	beforeTransactionCompletion()	A before-completion callback to the owner.
Transaction	beginTransaction()	Begin a unit of work and return the associated Transaction object.
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.
Session.LockRequest	buildLockRequest(LockOptions lockOptions)	Deprecated.
<T> IdentifierLoadAccess<T>	byId(Class<T> entityClass)	Create an IdentifierLoadAccess instance to retrieve an instance of the given entity type by its primary key.
<T> IdentifierLoadAccess<T>	byId(String entityName)	Create an IdentifierLoadAccess instance to retrieve an instance of the named entity type by its primary key.
<T> MultiIdentifierLoadAccess<T>	byMultipleIds(Class<T> entityClass)	Create a MultiIdentifierLoadAccess instance to retrieve multiple instances of the given entity type by their primary key values, using batching.
<T> MultiIdentifierLoadAccess<T>	byMultipleIds(String entityName)	Create a MultiIdentifierLoadAccess instance to retrieve multiple instances of the named entity type by their primary key values, using batching.
<T> NaturalIdMultiLoadAccess<T>	byMultipleNaturalId(Class<T> entityClass)	Create a MultiIdentifierLoadAccess instance to retrieve multiple instances of the given entity type by their by natural id values, using batching.
<T> NaturalIdMultiLoadAccess<T>	byMultipleNaturalId(String entityName)	Create a MultiIdentifierLoadAccess instance to retrieve multiple instances of the named entity type by their by natural id values, using batching.
<T> NaturalIdLoadAccess<T>	byNaturalId(Class<T> entityClass)	Create a NaturalIdLoadAccess instance to retrieve an instance of the given entity type by its natural id, which may be a composite natural id.
<T> NaturalIdLoadAccess<T>	byNaturalId(String entityName)	Create a NaturalIdLoadAccess instance to retrieve an instance of the named entity type by its natural id, which may be a composite natural id.
<T> SimpleNaturalIdLoadAccess<T>	bySimpleNaturalId(Class<T> entityClass)	Create a SimpleNaturalIdLoadAccess instance to retrieve an instance of the given entity type by its natural id, which must be a simple (non-composite) value.
<T> SimpleNaturalIdLoadAccess<T>	bySimpleNaturalId(String entityName)	Create a SimpleNaturalIdLoadAccess instance to retrieve an instance of the named entity type by its natural id, which must be a simple (non-composite) value.
void	cancelQuery()	Cancel the execution of the current query.
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.
void	checkTransactionNeededForUpdateOperation(String exceptionMessage)	Check if an active Transaction is available before performing an update operation against the database.
void	clear()	Completely clear the session.
void	close()	End the session by releasing the JDBC connection and cleaning up.
boolean	contains(Object object)	Check if the instance is a managed entity instance belonging to the current persistence context.
boolean	contains(String entityName, Object object)	Determine if the given entity is associated with this session.
<T> RootGraphImplementor<T>	createEntityGraph(Class<T> rootType)	Create a new mutable EntityGraph with only a root node.
<T> RootGraph<T>	createEntityGraph(Class<T> rootType, String graphName)	Create a new mutable copy of the named EntityGraph, or return null if there is no graph with the given name.
RootGraphImplementor<?>	createEntityGraph(String graphName)	Create a new mutable copy of the named EntityGraph, or return null if there is no graph with the given name.
MutationQuery	createMutationQuery(CriteriaDelete deleteQuery)	Create a MutationQuery from the given delete criteria tree
MutationQuery	createMutationQuery(CriteriaUpdate updateQuery)	Create a MutationQuery from the given update criteria tree
MutationQuery	createMutationQuery(String statementString)	Create a MutationQuery reference for the given HQL insert, update, or delete statement.
MutationQuery	createMutationQuery(JpaCriteriaInsert insertSelect)	Create a MutationQuery from the given insert criteria tree
MutationQuery	createMutationQuery(JpaCriteriaInsertSelect insertSelect)	Create a MutationQuery from the given insert-select criteria tree
MutationQuery	createNamedMutationQuery(String name)	Create a MutationQuery instance for the given named insert, update, or delete HQL query.
QueryImplementor	createNamedQuery(String name)	Create a typed Query instance for the given named query.
<T> QueryImplementor<T>	createNamedQuery(String name, Class<T> resultClass)	Create a typed Query instance for the given named query.
SelectionQuery<?>	createNamedSelectionQuery(String name)	Create a SelectionQuery instance for the named NamedQuery.
<R> SelectionQuery<R>	createNamedSelectionQuery(String name, Class<R> resultType)	Create a SelectionQuery instance for the named NamedQuery with the given result type.
ProcedureCall	createNamedStoredProcedureQuery(String name)	Obtain a ProcedureCall based on a named template
MutationQuery	createNativeMutationQuery(String sqlString)	Create a NativeQuery instance for the given native SQL statement.
NativeQueryImplementor	createNativeQuery(String sqlString)	Create a NativeQuery instance for the given native SQL query.
NativeQueryImplementor	createNativeQuery(String sqlString, Class resultClass)	Create a NativeQuery instance for the given native SQL query using an implicit mapping to the specified Java type.
<T> NativeQueryImplementor<T>	createNativeQuery(String sqlString, Class<T> resultClass, String tableAlias)	Create a NativeQuery instance for the given native SQL query using an implicit mapping to the specified Java entity type.
NativeQueryImplementor	createNativeQuery(String sqlString, String resultSetMappingName)	Create a NativeQuery instance for the given native SQL query using an explicit mapping to the specified Java type.
<T> NativeQueryImplementor<T>	createNativeQuery(String sqlString, String resultSetMappingName, Class<T> resultClass)	Create a NativeQuery instance for the given native SQL query using an explicit mapping to the specified Java type.
QueryImplementor	createQuery(CriteriaDelete deleteQuery)	Create a Query for the given JPA CriteriaDelete.
<T> QueryImplementor<T>	createQuery(CriteriaQuery<T> criteriaQuery)	Create a Query for the given JPA CriteriaQuery.
QueryImplementor	createQuery(CriteriaUpdate updateQuery)	Create a Query for the given JPA CriteriaUpdate.
QueryImplementor	createQuery(String queryString)	Create a Query instance for the given HQL query, or HQL insert, update, or delete statement.
<T> QueryImplementor<T>	createQuery(String queryString, Class<T> resultType)	Create a typed Query instance for the given HQL query string and given query result type.
<R> SelectionQuery<R>	createSelectionQuery(CriteriaQuery<R> criteria)	Create a SelectionQuery reference for the given CriteriaQuery.
SelectionQuery<?>	createSelectionQuery(String hqlString)	Create a SelectionQuery reference for the given HQL select statement.
<R> SelectionQuery<R>	createSelectionQuery(String hqlString, Class<R> resultType)	Create a SelectionQuery instance for the given HQL query string and given query result type.
ProcedureCall	createStoredProcedureCall(String procedureName)	Create a ProcedureCall to a stored procedure.
ProcedureCall	createStoredProcedureCall(String procedureName, Class<?>... resultClasses)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureCall(String procedureName, String... resultSetMappings)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureQuery(String procedureName)	Create a ProcedureCall to a stored procedure.
ProcedureCall	createStoredProcedureQuery(String procedureName, Class... resultClasses)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureQuery(String procedureName, String... resultSetMappings)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
protected SessionImplementor	delegate()	Returns the delegate session.
void	delete(Object object)	Remove a persistent instance from the datastore.
void	delete(String entityName, Object object)	Remove a persistent instance from the datastore.
void	delete(String entityName, Object child, boolean isCascadeDeleteEnabled, DeleteContext transientEntities)
void	detach(Object entity)	Remove this instance from the session cache.
void	disableFetchProfile(String name)	Disable the fetch profile with the given name in this session.
void	disableFilter(String filterName)	Disable the named filter for the current session.
<T> T	doReturningWork(ReturningWork<T> work)	Perform work using the Connection underlying by this session, and return a result.
void	doWork(Work work)	Perform work using the Connection underlying by this session.
void	enableFetchProfile(String name)	Enable the fetch profile with the given name in this session.
Filter	enableFilter(String filterName)	Enable the named filter for this current session.
void	evict(Object object)	Remove this instance from the session cache.
<T> T	execute(LobCreationContext.Callback<T> callback)	Execute the given callback, making sure it has access to a viable JDBC Connection.
<T> @Nullable T	find(Class<T> entityClass, Object primaryKey)	Find by primary key.
<T> @Nullable T	find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)	Find by primary key and lock.
<T> @Nullable T	find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String,Object> properties)	Find by primary key and lock, using the specified properties.
<T> @Nullable T	find(Class<T> entityClass, Object primaryKey, Map<String,Object> properties)	Find by primary key, using the specified properties.
void	flush()	Force this session to flush.
void	flushBeforeTransactionCompletion()
void	forceFlush(EntityEntry e)	Initiate a flush to force deletion of a re-persisted entity.
void	forceFlush(EntityKey e)	Initiate a flush to force deletion of a re-persisted entity.
EntityKey	generateEntityKey(Object id, EntityPersister persister)	Instantiate an EntityKey with the given id and for the entity represented by the given EntityPersister.
<T> T	get(Class<T> theClass, Object id)	Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance.
<T> T	get(Class<T> theClass, Object id, LockMode lockMode)	Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance.
<T> T	get(Class<T> theClass, Object id, LockOptions lockOptions)	Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance.
Object	get(String entityName, Object id)	Return the persistent instance of the given named entity with the given identifier, or null if there is no such persistent instance.
Object	get(String entityName, Object id, LockMode lockMode)	Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance.
Object	get(String entityName, Object id, LockOptions lockOptions)	Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance.
ActionQueue	getActionQueue()	Get the ActionQueue associated with this session.
CacheMode	getCacheMode()	Get the current cache mode for this session.
CacheRetrieveMode	getCacheRetrieveMode()	The JPA-defined CacheRetrieveMode.
CacheStoreMode	getCacheStoreMode()	The JPA-defined CacheStoreMode.
CacheTransactionSynchronization	getCacheTransactionSynchronization()	The current CacheTransactionSynchronization associated with this session.
Object	getContextEntityIdentifier(Object object)	Return the identifier of the persistent object, or null if it is not associated with this session.
HibernateCriteriaBuilder	getCriteriaBuilder()	Obtain a HibernateCriteriaBuilder which may be used to construct criteria queries.
LockMode	getCurrentLockMode(Object object)	Determine the current LockMode of the given managed instance associated with this session.
Object	getDelegate()	This is the implementation of EntityManager.getDelegate().
Filter	getEnabledFilter(String filterName)	Retrieve a currently enabled filter by name.
RootGraphImplementor<?>	getEntityGraph(String graphName)	Retrieve the named EntityGraph as an immutable graph, or return null if there is no graph with the given name.
<T> List<EntityGraph<? super T>>	getEntityGraphs(Class<T> entityClass)	Retrieve all named EntityGraphs with the given type.
EntityManagerFactory	getEntityManagerFactory()	Return the entity manager factory for the entity manager.
String	getEntityName(Object object)	Return the entity name for a persistent entity.
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.
EventManager	getEventManager()
ExceptionConverter	getExceptionConverter()	Obtain an ExceptionConverter for reporting an error.
SessionFactoryImplementor	getFactory()	The factory which created this session.
int	getFetchBatchSize()	Get the maximum batch size for batch fetching associations by id in this session.
FlushModeType	getFlushMode()	Get the current JPA flush mode for this session.
FlushMode	getHibernateFlushMode()	Get the current flush mode for this session.
Object	getIdentifier(Object object)	Return the identifier value of the given entity associated with this session.
Interceptor	getInterceptor()	Retrieves the Interceptor associated with this session.
Integer	getJdbcBatchSize()	Get the session-level JDBC batch size for the current session.
JdbcConnectionAccess	getJdbcConnectionAccess()
JdbcCoordinator	getJdbcCoordinator()	Obtain the JdbcCoordinator for this session.
JdbcServices	getJdbcServices()	Obtain the JdbcServices for the factory which created this session.
JdbcSessionContext	getJdbcSessionContext()
TimeZone	getJdbcTimeZone()	The JDBC TimeZone used when writing a value of type Time or Timestamp to a JDBC PreparedStatement, or when reading from a JDBC ResultSet.
LoadQueryInfluencers	getLoadQueryInfluencers()	Get the LoadQueryInfluencers associated with this session.
LobCreator	getLobCreator()	Obtain access to the LobCreator.
LobHelper	getLobHelper()	Obtain a factory for instances of Blob and Clob.
LockModeType	getLockMode(Object entity)	Get the current lock mode for the entity instance.
Metamodel	getMetamodel()	Return an instance of Metamodel interface for access to the metamodel of the persistence unit.
NativeQueryImplementor	getNamedNativeQuery(String name)	Get a NativeQuery instance for a named native SQL query
NativeQueryImplementor	getNamedNativeQuery(String name, String resultSetMapping)	Get a NativeQuery instance for a named native SQL query
ProcedureCall	getNamedProcedureCall(String name)	Obtain a ProcedureCall based on a named template
QueryImplementor	getNamedQuery(String name)	Create a Query instance for the named query.
boolean	getNativeJdbcParametersIgnored()
PersistenceContext	getPersistenceContext()	Get the persistence context for this session.
PersistenceContext	getPersistenceContextInternal()	Similar to SharedSessionContractImplementor.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.
int	getPreferredSqlTypeCodeForBoolean()	The JDBC type code used to bind a null boolean value.
Map<String,Object>	getProperties()	Get the properties and hints and associated values that are in effect for the entity manager.
<T> T	getReference(Class<T> entityClass, Object id)	Return a reference to the persistent instance with the given class and identifier, making the assumption that the instance is still persistent in the database.
Object	getReference(String entityName, Object id)	Return a reference to the persistent instance of the given named entity with the given identifier, making the assumption that the instance is still persistent in the database.
<T> T	getReference(T object)	Return a reference to the persistent instance with the same identity as the given instance, which might be detached, making the assumption that the instance is still persistent in the database.
SessionImplementor	getSession()	Returns this object, fulfilling the contract of WrapperOptions.
SessionFactoryImplementor	getSessionFactory()	Get the session factory which created this session.
UUID	getSessionIdentifier()	Obtain a UUID which uniquely identifies this session.
SessionStatistics	getStatistics()	Get the statistics for this session.
String	getTenantIdentifier()	Obtain the tenant identifier associated with this session.
Object	getTenantIdentifierValue()	Obtain the tenant identifier associated with this session.
Transaction	getTransaction()	Get the Transaction instance associated with this session.
TransactionCoordinator	getTransactionCoordinator()	Obtain the builder for TransactionCoordinator instances
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)	Instantiate the entity class, initializing with the given identifier.
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	isAutoCloseSessionEnabled()	Is auto-close at transaction completion enabled?
boolean	isClosed()	Determines whether the session is closed.
boolean	isConnected()	Check if the session is currently connected.
boolean	isCriteriaCopyTreeEnabled()
boolean	isDefaultReadOnly()	Will entities and proxies that are loaded into this session be made read-only by default?
boolean	isDirty()	Does this session contain any changes which must be synchronized with the database?
boolean	isEventSource()	Determines if this session implements EventSource.
boolean	isFetchProfileEnabled(String name)	Is the fetch profile with the given name enabled in this session?
boolean	isJoinedToTransaction()	Check if the session is joined to the current transaction.
boolean	isOpen()	Check if the session is still open.
boolean	isOpenOrWaitingForAutoClose()	Determines whether the session is open or is waiting for auto-close.
boolean	isReadOnly(Object entityOrProxy)	Is the specified entity or proxy read-only?
boolean	isSubselectFetchingEnabled()	Determine if subselect fetching is enabled in this session.
boolean	isTransactionInProgress()	Does this session have an active Hibernate transaction, or is it associated with a JTA transaction currently in progress?
void	joinTransaction()	Join the currently-active JTA transaction.
<T> T	load(Class<T> theClass, Object id)	Return the persistent instance of the given entity class with the given identifier, making the assumption that the instance exists in the database.
<T> T	load(Class<T> theClass, Object id, LockMode lockMode)	Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.
<T> T	load(Class<T> theClass, Object id, LockOptions lockOptions)	Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.
void	load(Object object, Object id)	Read the persistent state associated with the given identifier into the given transient instance.
Object	load(String entityName, Object id)	Return the persistent instance of the given entity class with the given identifier, making the assumption that the instance exists in the database.
Object	load(String entityName, Object id, LockMode lockMode)	Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.
Object	load(String entityName, Object id, LockOptions lockOptions)	Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.
void	lock(Object entity, LockModeType lockMode)	Lock an entity instance that is contained in the persistence context with the specified lock mode type.
void	lock(Object entity, LockModeType lockMode, Map<String,Object> properties)	Lock an entity instance that is contained in the persistence context with the specified lock mode type and with specified properties.
void	lock(Object object, LockMode lockMode)	Obtain the specified lock level on the given managed instance associated with this session.
void	lock(Object object, LockOptions lockOptions)	Obtain a lock on the given managed instance associated with this session, using the given lock options.
void	lock(String entityName, Object object, LockMode lockMode)	Obtain the specified lock level on the given managed instance associated with this session.
void	lock(String entityName, Object object, LockOptions lockOptions)	Cascade the lock operation to the given child entity.
void	markForRollbackOnly()	Marks current transaction, if any, for rollback only.
void	merge(String entityName, Object object, MergeContext copiedAlready)
<T> T	merge(String entityName, T object)	Copy the state of the given object onto the persistent object with the same identifier.
<T> T	merge(T object)	Copy the state of the given object onto the persistent object with the same identifier.
void	persist(Object object)	Make a transient instance persistent and mark it for later insertion in the database.
void	persist(String entityName, Object object)	Make a transient instance persistent and mark it for later insertion in the database.
void	persist(String entityName, Object object, PersistContext createdAlready)
void	persistOnFlush(String entityName, Object object, PersistContext copiedAlready)
void	prepareForQueryExecution(boolean requiresTxn)	Prepare for the execution of a Query or ProcedureCall
void	refresh(Object object)	Reread the state of the given managed instance associated with this session from the underlying database.
void	refresh(Object entity, LockModeType lockMode)	Refresh the state of the instance from the database, overwriting changes made to the entity, if any, and lock it with respect to given lock mode type.
void	refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)	Refresh the state of the instance from the database, overwriting changes made to the entity, if any, and lock it with respect to given lock mode type and with specified properties.
void	refresh(Object entity, Map<String,Object> properties)	Refresh the state of the instance from the database, using the specified properties, and overwriting changes made to the entity, if any.
void	refresh(Object object, LockMode lockMode)	Reread the state of the given managed instance from the underlying database, obtaining the given LockMode.
void	refresh(Object object, LockOptions lockOptions)	Reread the state of the given managed instance from the underlying database, obtaining the given LockMode.
void	refresh(String entityName, Object object)	Reread the state of the given managed instance associated with this session from the underlying database.
void	refresh(String entityName, Object object, RefreshContext refreshedAlready)
void	refresh(String entityName, Object object, LockOptions lockOptions)	Reread the state of the given managed instance from the underlying database, obtaining the given LockMode.
void	remove(Object entity)	Mark a persistence instance associated with this session for removal from the underlying database.
void	removeOrphanBeforeUpdates(String entityName, Object child)
void	replicate(Object object, ReplicationMode replicationMode)	Persist the state of the given detached instance, reusing the current identifier value.
void	replicate(String entityName, Object object, ReplicationMode replicationMode)	Persist the state of the given detached instance, reusing the current identifier value.
Object	save(Object object)	Persist the given transient instance, first assigning a generated identifier.
Object	save(String entityName, Object object)	Persist the given transient instance, first assigning a generated identifier.
void	saveOrUpdate(Object object)	Either Session.save(Object) or Session.update(Object) the given instance, depending upon resolution of the unsaved-value checks (see the manual for discussion of unsaved-value checking).
void	saveOrUpdate(String entityName, Object object)	Either Session.save(String, Object) or Session.update(String, Object) the given instance, depending upon resolution of the unsaved-value checks (see the manual for discussion of unsaved-value checking).
SharedSessionBuilder	sessionWithOptions()	Obtain a Session builder with the ability to copy certain information from this session.
void	setAutoClear(boolean enabled)	Enable or disable automatic cache clearing from after transaction completion.
void	setCacheMode(CacheMode cm)	Set the current cache mode for this session.
void	setCacheRetrieveMode(CacheRetrieveMode cacheRetrieveMode)	Enable or disable reads from the second-level cache.
void	setCacheStoreMode(CacheStoreMode cacheStoreMode)	Enable or disable writes to the second-level cache.
void	setCriteriaCopyTreeEnabled(boolean jpaCriteriaCopyComplianceEnabled)
void	setDefaultReadOnly(boolean readOnly)	Change the default for entities and proxies loaded into this session from modifiable to read-only mode, or from modifiable to read-only mode.
void	setFetchBatchSize(int batchSize)	Set the maximum batch size for batch fetching associations by id in this session.
void	setFlushMode(FlushModeType flushModeType)	Set the current JPA flush mode for this session.
void	setHibernateFlushMode(FlushMode flushMode)	Set the current flush mode for this session.
void	setJdbcBatchSize(Integer jdbcBatchSize)	Set the session-level JDBC batch size.
void	setNativeJdbcParametersIgnored(boolean nativeJdbcParametersIgnored)
void	setProperty(String propertyName, Object value)	Set an entity manager property or hint.
void	setReadOnly(Object entityOrProxy, boolean readOnly)	Set an unmodified persistent object to read-only mode, or a read-only object to modifiable mode.
void	setSubselectFetchingEnabled(boolean enabled)	Enable or disable subselect fetching in this session.
boolean	shouldAutoClose()	Should this session be automatically closed after the current transaction completes?
boolean	shouldAutoJoinTransaction()	Indicates whether an active transaction should be automatically joined.
void	startTransactionBoundary()	Callback indicating recognition of entering into a transactional context whether that is explicitly via the Hibernate Transaction API or via registration of Hibernate's JTA Synchronization impl with a JTA Transaction
<T> T	unwrap(Class<T> cls)	Return an object of the specified type to allow access to the provider-specific API.
void	update(Object object)	Update the persistent instance with the identifier of the given detached instance.
void	update(String entityName, Object object)	Update the persistent instance with the identifier of the given detached instance.
boolean	useStreamForLobBinding()	Determines whether streams should be used for binding LOB values.

Methods inherited from class java.lang.Object

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

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

getSqlExceptionHelper

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

fromContext

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

asSessionImplementor, isSessionImplementor

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

asStatelessSession, bestGuessEntityName, getConfiguredJdbcBatchSize, getSessionToken, getTypeConfiguration, isEnforcingFetchGraph, isStatelessSession, setEnforcingFetchGraph

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

getDialect

Field Details

delegate

protected final SessionImplementor delegate

Constructor Details

SessionDelegatorBaseImpl

public SessionDelegatorBaseImpl(SessionImplementor delegate)

Method Details

delegate

protected SessionImplementor delegate()

Returns the delegate session.

See Also:

• getDelegate()

execute

public <T> T execute(LobCreationContext.Callback<T> callback)

Description copied from interface: LobCreationContext

Execute the given callback, making sure it has access to a viable JDBC Connection.

Specified by:

execute in interface LobCreationContext

Type Parameters:

T - The Java type of the type of LOB being created. One of Blob, Clob, NClob

Parameters:

callback - The callback to execute .

Returns:

The LOB created by the callback.

getTenantIdentifier

public String getTenantIdentifier()

Description copied from interface: SharedSessionContract

Obtain the tenant identifier associated with this session.

Specified by:

getTenantIdentifier in interface SharedSessionContract

Returns:

The tenant identifier associated with this session, or null

getTenantIdentifierValue

public Object getTenantIdentifierValue()

Description copied from interface: SharedSessionContract

Obtain the tenant identifier associated with this session.

Specified by:

getTenantIdentifierValue in interface SharedSessionContract

Returns:

The tenant identifier associated with this session, or null

getSessionIdentifier

public UUID getSessionIdentifier()

Description copied from interface: SharedSessionContractImplementor

Obtain a UUID which uniquely identifies this session.

The UUID is useful mainly for logging.

Specified by:

getSessionIdentifier in interface SharedSessionContractImplementor

getJdbcConnectionAccess

public JdbcConnectionAccess getJdbcConnectionAccess()

Specified by:

getJdbcConnectionAccess in interface JdbcSessionOwner

generateEntityKey

public EntityKey generateEntityKey(Object id,
 EntityPersister persister)

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

generateEntityKey in interface SharedSessionContractImplementor

Parameters:

id - The entity id

persister - The entity persister

Returns:

The entity key

getInterceptor

public Interceptor getInterceptor()

Description copied from interface: SharedSessionContractImplementor

Retrieves the Interceptor associated with this session.

Specified by:

getInterceptor in interface SharedSessionContractImplementor

setAutoClear

public void setAutoClear(boolean enabled)

Description copied from interface: SharedSessionContractImplementor

Enable or disable automatic cache clearing from after transaction completion.

Specified by:

setAutoClear in interface SharedSessionContractImplementor

isTransactionInProgress

public boolean isTransactionInProgress()

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

isTransactionInProgress in interface SharedSessionContractImplementor

checkTransactionNeededForUpdateOperation

public void checkTransactionNeededForUpdateOperation(String exceptionMessage)

Description copied from interface: SharedSessionContractImplementor

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.

Specified by:

checkTransactionNeededForUpdateOperation in interface SharedSessionContractImplementor

Parameters:

exceptionMessage - the message to use for the TransactionRequiredException

initializeCollection

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

Description copied from interface: SharedSessionContractImplementor

Initialize the given collection (if not already initialized).

Specified by:

initializeCollection in interface SharedSessionContractImplementor

Throws:

HibernateException

internalLoad

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

Description copied from interface: SharedSessionContractImplementor

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.

Specified by:

internalLoad in interface SharedSessionContractImplementor

Throws:

HibernateException

immediateLoad

public Object immediateLoad(String entityName,
 Object id)
                     throws HibernateException

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

immediateLoad in interface SharedSessionContractImplementor

Throws:

HibernateException

getFactory

public SessionFactoryImplementor getFactory()

Description copied from interface: SharedSessionContract

The factory which created this session.

Specified by:

getFactory in interface QueryProducerImplementor

Specified by:

getFactory in interface SharedSessionContract

Specified by:

getFactory in interface SharedSessionContractImplementor

getEntityPersister

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

Description copied from interface: SharedSessionContractImplementor

Get the EntityPersister for the given entity instance.

Specified by:

getEntityPersister in interface SharedSessionContractImplementor

Parameters:

entityName - optional entity name

object - the entity instance

Throws:

HibernateException

getEntityUsingInterceptor

public Object getEntityUsingInterceptor(EntityKey key)
                                 throws HibernateException

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

getEntityUsingInterceptor in interface SharedSessionContractImplementor

Throws:

HibernateException

getContextEntityIdentifier

public Object getContextEntityIdentifier(Object object)

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

getContextEntityIdentifier in interface SharedSessionContractImplementor

bestGuessEntityName

public String bestGuessEntityName(Object object)

Description copied from interface: SharedSessionContractImplementor

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.

Specified by:

bestGuessEntityName in interface SharedSessionContractImplementor

guessEntityName

public String guessEntityName(Object entity)
                       throws HibernateException

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

guessEntityName in interface SharedSessionContractImplementor

Throws:

HibernateException

instantiate

public Object instantiate(String entityName,
 Object id)
                   throws HibernateException

Description copied from interface: SharedSessionContractImplementor

Instantiate the entity class, initializing with the given identifier.

Specified by:

instantiate in interface SharedSessionContractImplementor

Throws:

HibernateException

getPersistenceContext

public PersistenceContext getPersistenceContext()

Description copied from interface: SharedSessionContractImplementor

Get the persistence context for this session.

See SharedSessionContractImplementor.getPersistenceContextInternal() for a faster alternative.

Specified by:

getPersistenceContext in interface SharedSessionContractImplementor

getCacheMode

public CacheMode getCacheMode()

Description copied from interface: Session

Get the current cache mode for this session.

Specified by:

getCacheMode in interface QueryProducerImplementor

Specified by:

getCacheMode in interface Session

Specified by:

getCacheMode in interface SharedSessionContractImplementor

Returns:

the current cache mode

getCacheRetrieveMode

public CacheRetrieveMode getCacheRetrieveMode()

Description copied from interface: Session

The JPA-defined CacheRetrieveMode.

Specified by:

getCacheRetrieveMode in interface Session

See Also:

• Session.getCacheMode()

getCacheStoreMode

public CacheStoreMode getCacheStoreMode()

Description copied from interface: Session

The JPA-defined CacheStoreMode.

Specified by:

getCacheStoreMode in interface Session

See Also:

• Session.getCacheMode()

setCacheMode

public void setCacheMode(CacheMode cm)

Description copied from interface: Session

Set the current cache mode for this session.

The cache mode determines the manner in which this session can interact with the second level cache.

Specified by:

setCacheMode in interface Session

Specified by:

setCacheMode in interface SharedSessionContractImplementor

Parameters:

cm - the new cache mode

setCacheStoreMode

public void setCacheStoreMode(CacheStoreMode cacheStoreMode)

Description copied from interface: Session

Enable or disable writes to the second-level cache.

Specified by:

setCacheStoreMode in interface Session

Parameters:

cacheStoreMode - a JPA-defined CacheStoreMode

See Also:

• Session.setCacheMode(CacheMode)

setCacheRetrieveMode

public void setCacheRetrieveMode(CacheRetrieveMode cacheRetrieveMode)

Description copied from interface: Session

Enable or disable reads from the second-level cache.

Specified by:

setCacheRetrieveMode in interface Session

Parameters:

cacheRetrieveMode - a JPA-defined CacheRetrieveMode

See Also:

• Session.setCacheMode(CacheMode)

setCriteriaCopyTreeEnabled

public void setCriteriaCopyTreeEnabled(boolean jpaCriteriaCopyComplianceEnabled)

Specified by:

setCriteriaCopyTreeEnabled in interface SharedSessionContractImplementor

isCriteriaCopyTreeEnabled

public boolean isCriteriaCopyTreeEnabled()

Specified by:

isCriteriaCopyTreeEnabled in interface SharedSessionContractImplementor

getNativeJdbcParametersIgnored

public boolean getNativeJdbcParametersIgnored()

Specified by:

getNativeJdbcParametersIgnored in interface SharedSessionContractImplementor

setNativeJdbcParametersIgnored

public void setNativeJdbcParametersIgnored(boolean nativeJdbcParametersIgnored)

Specified by:

setNativeJdbcParametersIgnored in interface SharedSessionContractImplementor

isOpen

public boolean isOpen()

Description copied from interface: SharedSessionContract

Check if the session is still open.

Specified by:

isOpen in interface EntityManager

Specified by:

isOpen in interface SharedSessionContract

Returns:

boolean

isConnected

public boolean isConnected()

Description copied from interface: SharedSessionContract

Check if the session is currently connected.

Specified by:

isConnected in interface SharedSessionContract

Returns:

boolean

checkOpen

public void checkOpen(boolean markForRollbackIfClosed)

Description copied from interface: SharedSessionContractImplementor

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.)

Specified by:

checkOpen in interface SharedSessionContractImplementor

markForRollbackOnly

public void markForRollbackOnly()

Description copied from interface: SharedSessionContractImplementor

Marks current transaction, if any, for rollback only.

Specified by:

markForRollbackOnly in interface SharedSessionContractImplementor

getFlushMode

public FlushModeType getFlushMode()

Description copied from interface: Session

Get the current JPA flush mode for this session.

Specified by:

getFlushMode in interface EntityManager

Specified by:

getFlushMode in interface Session

Specified by:

getFlushMode in interface SharedSessionContractImplementor

Returns:

the FlushModeType currently in effect

setFlushMode

public void setFlushMode(FlushModeType flushModeType)

Description copied from interface: Session

Set the current JPA flush mode for this session.

Flushing is the process of synchronizing the underlying persistent store with persistable state held in memory. The current flush mode determines when the session is automatically flushed.

Specified by:

setFlushMode in interface EntityManager

Specified by:

setFlushMode in interface Session

Parameters:

flushModeType - the new FlushModeType

See Also:

• for additional options

setHibernateFlushMode

public void setHibernateFlushMode(FlushMode flushMode)

Description copied from interface: Session

Set the current flush mode for this session.

Flushing is the process of synchronizing the underlying persistent store with persistable state held in memory. The current flush mode determines when the session is automatically flushed.

The default flush mode is sometimes unnecessarily aggressive. For a logically "read only" session, it's reasonable to set the session's flush mode to FlushMode.MANUAL at the start of the session in order to avoid some unnecessary work.

Note that FlushMode defines more options than FlushModeType.

Specified by:

setHibernateFlushMode in interface Session

Specified by:

setHibernateFlushMode in interface SharedSessionContractImplementor

Parameters:

flushMode - the new FlushMode

getHibernateFlushMode

public FlushMode getHibernateFlushMode()

Description copied from interface: Session

Get the current flush mode for this session.

Specified by:

getHibernateFlushMode in interface QueryProducerImplementor

Specified by:

getHibernateFlushMode in interface Session

Specified by:

getHibernateFlushMode in interface SharedSessionContractImplementor

Returns:

the FlushMode currently in effect

lock

public void lock(Object entity,
 LockModeType lockMode)

Description copied from interface: EntityManager

Lock an entity instance that is contained in the persistence context with the specified lock mode type.

If a pessimistic lock mode type is specified and the entity contains a version attribute, the persistence provider must also perform optimistic version checks when obtaining the database lock. If these checks fail, the OptimisticLockException will be thrown.

If the lock mode type is pessimistic and the entity instance is found but cannot be locked:

• the PessimisticLockException will be thrown if the database locking failure causes transaction-level rollback
• the LockTimeoutException will be thrown if the database locking failure causes only statement-level rollback

Specified by:

lock in interface EntityManager

Parameters:

entity - entity instance

lockMode - lock mode

lock

public void lock(Object entity,
 LockModeType lockMode,
 Map<String,Object> properties)

Description copied from interface: EntityManager

Lock an entity instance that is contained in the persistence context with the specified lock mode type and with specified properties.

If a pessimistic lock mode type is specified and the entity contains a version attribute, the persistence provider must also perform optimistic version checks when obtaining the database lock. If these checks fail, the OptimisticLockException will be thrown.

If the lock mode type is pessimistic and the entity instance is found but cannot be locked:

• the PessimisticLockException will be thrown if the database locking failure causes transaction-level rollback
• the LockTimeoutException will be thrown if the database locking failure causes only statement-level rollback

If a vendor-specific property or hint is not recognized, it is silently ignored.

Portable applications should not rely on the standard timeout hint. Depending on the database in use and the locking mechanisms used by the provider, the hint may or may not be observed.

Specified by:

lock in interface EntityManager

Parameters:

entity - entity instance

lockMode - lock mode

properties - standard and vendor-specific properties and hints

flush

public void flush()

Description copied from interface: Session

Force this session to flush. Must be called at the end of a unit of work, before the transaction is committed. Depending on the current flush mode, the session might automatically flush when EntityTransaction.commit() is called, and it is not necessary to call this method directly.

Flushing is the process of synchronizing the underlying persistent store with persistable state held in memory.

Specified by:

flush in interface EntityManager

Specified by:

flush in interface Session

Specified by:

flush in interface SharedSessionContractImplementor

isEventSource

public boolean isEventSource()

Description copied from interface: SharedSessionContractImplementor

Determines if this session implements EventSource.

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

Specified by:

isEventSource in interface SharedSessionContractImplementor

asEventSource

public EventSource asEventSource()

Description copied from interface: SharedSessionContractImplementor

Cast this session to EventSource if possible.

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

Specified by:

asEventSource in interface SharedSessionContractImplementor

afterScrollOperation

public void afterScrollOperation()

Description copied from interface: SharedSessionContractImplementor

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.

Specified by:

afterScrollOperation in interface SharedSessionContractImplementor

getTransactionCoordinator

public TransactionCoordinator getTransactionCoordinator()

Description copied from interface: JdbcSessionOwner

Obtain the builder for TransactionCoordinator instances

Specified by:

getTransactionCoordinator in interface JdbcSessionOwner

Returns:

The TransactionCoordinatorBuilder

getJdbcCoordinator

public JdbcCoordinator getJdbcCoordinator()

Description copied from interface: SharedSessionContractImplementor

Obtain the JdbcCoordinator for this session.

Specified by:

getJdbcCoordinator in interface SharedSessionContractImplementor

getJdbcServices

public JdbcServices getJdbcServices()

Description copied from interface: SharedSessionContractImplementor

Obtain the JdbcServices for the factory which created this session.

Specified by:

getJdbcServices in interface SharedSessionContractImplementor

getJdbcSessionContext

public JdbcSessionContext getJdbcSessionContext()

Specified by:

getJdbcSessionContext in interface JdbcSessionOwner

isClosed

public boolean isClosed()

Description copied from interface: SharedSessionContractImplementor

Determines whether the session is closed.

Specified by:

isClosed in interface SharedSessionContractImplementor

Returns:

true if the session is closed; false otherwise.

checkOpen

public void checkOpen()

Description copied from interface: SharedSessionContractImplementor

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.)

Specified by:

checkOpen in interface SharedSessionContractImplementor

isOpenOrWaitingForAutoClose

public boolean isOpenOrWaitingForAutoClose()

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

isOpenOrWaitingForAutoClose in interface SharedSessionContractImplementor

Returns:

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

shouldAutoClose

public boolean shouldAutoClose()

Description copied from interface: SharedSessionContractImplementor

Should this session be automatically closed after the current transaction completes?

Specified by:

shouldAutoClose in interface SharedSessionContractImplementor

isAutoCloseSessionEnabled

public boolean isAutoCloseSessionEnabled()

Description copied from interface: SharedSessionContractImplementor

Is auto-close at transaction completion enabled?

Specified by:

isAutoCloseSessionEnabled in interface SharedSessionContractImplementor

See Also:

• TransactionSettings.AUTO_CLOSE_SESSION
• SessionFactoryOptions.isAutoCloseSessionEnabled()

shouldAutoJoinTransaction

public boolean shouldAutoJoinTransaction()

Description copied from interface: TransactionCoordinatorBuilder.Options

Indicates whether an active transaction should be automatically joined. Only relevant for JTA-based TransactionCoordinator instances.

Specified by:

shouldAutoJoinTransaction in interface TransactionCoordinatorBuilder.Options

Returns:

true indicates the active transaction should be auto joined; false indicates it should not (until TransactionCoordinator.explicitJoin() is called).

getLoadQueryInfluencers

public LoadQueryInfluencers getLoadQueryInfluencers()

Description copied from interface: SharedSessionContractImplementor

Get the LoadQueryInfluencers associated with this session.

Specified by:

getLoadQueryInfluencers in interface SharedSessionContractImplementor

Returns:

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

getExceptionConverter

public ExceptionConverter getExceptionConverter()

Description copied from interface: SharedSessionContractImplementor

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.

Specified by:

getExceptionConverter in interface SharedSessionContractImplementor

Returns:

the ExceptionConverter for this Session.

getPersistenceContextInternal

public PersistenceContext getPersistenceContextInternal()

Description copied from interface: SharedSessionContractImplementor

Similar to SharedSessionContractImplementor.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.

Specified by:

getPersistenceContextInternal in interface SharedSessionContractImplementor

Returns:

the PersistenceContext associated to this session.

autoFlushIfRequired

public boolean autoFlushIfRequired(Set<String> querySpaces)
                            throws HibernateException

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

autoFlushIfRequired in interface SharedSessionContractImplementor

Parameters:

querySpaces - the tables named in the query.

Returns:

true if flush is required, false otherwise.

Throws:

HibernateException

autoFlushIfRequired

public boolean autoFlushIfRequired(Set<String> querySpaces,
 boolean skipPreFlush)
                            throws HibernateException

Specified by:

autoFlushIfRequired in interface SharedSessionContractImplementor

Throws:

HibernateException

autoPreFlush

public void autoPreFlush()

Specified by:

autoPreFlush in interface SharedSessionContractImplementor

afterOperation

public void afterOperation(boolean success)

Description copied from interface: SharedSessionContractImplementor

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.

Specified by:

afterOperation in interface SharedSessionContractImplementor

Parameters:

success - true if the operation a success

getEventListenerManager

public SessionEventListenerManager getEventListenerManager()

Description copied from interface: SharedSessionContractImplementor

Get the SessionEventListenerManager associated with this session.

Specified by:

getEventListenerManager in interface SharedSessionContractImplementor

accessTransaction

public Transaction accessTransaction()

Description copied from interface: SharedSessionContractImplementor

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

This method is primarily for internal or integrator use.

Specified by:

accessTransaction in interface SharedSessionContractImplementor

Returns:

the Transaction

beginTransaction

public Transaction beginTransaction()

Description copied from interface: SharedSessionContract

Begin a unit of work and return the associated Transaction object. If a new underlying transaction is required, begin the transaction. Otherwise, continue the new work in the context of the existing underlying transaction.

Specified by:

beginTransaction in interface SharedSessionContract

Returns:

a Transaction instance

See Also:

• SharedSessionContract.getTransaction()

getTransaction

public Transaction getTransaction()

Description copied from interface: SharedSessionContract

Get the Transaction instance associated with this session.

Specified by:

getTransaction in interface EntityManager

Specified by:

getTransaction in interface SharedSessionContract

Returns:

a Transaction instance

See Also:

• EntityManager.getTransaction()

startTransactionBoundary

public void startTransactionBoundary()

Description copied from interface: JdbcSessionOwner

Callback indicating recognition of entering into a transactional context whether that is explicitly via the Hibernate Transaction API or via registration of Hibernate's JTA Synchronization impl with a JTA Transaction

Specified by:

startTransactionBoundary in interface JdbcSessionOwner

getCacheTransactionSynchronization

public CacheTransactionSynchronization getCacheTransactionSynchronization()

Description copied from interface: SharedSessionContractImplementor

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

Specified by:

getCacheTransactionSynchronization in interface SharedSessionContractImplementor

afterTransactionBegin

public void afterTransactionBegin()

Description copied from interface: JdbcSessionOwner

A after-begin callback from the coordinator to its owner.

Specified by:

afterTransactionBegin in interface JdbcSessionOwner

beforeTransactionCompletion

public void beforeTransactionCompletion()

Description copied from interface: JdbcSessionOwner

A before-completion callback to the owner.

Specified by:

beforeTransactionCompletion in interface JdbcSessionOwner

afterTransactionCompletion

public void afterTransactionCompletion(boolean successful,
 boolean delayed)

Description copied from interface: JdbcSessionOwner

An after-completion callback to the owner.

Specified by:

afterTransactionCompletion in interface JdbcSessionOwner

Parameters:

successful - Was the transaction successful?

delayed - Is this a delayed after transaction completion call (aka after a timeout)?

flushBeforeTransactionCompletion

public void flushBeforeTransactionCompletion()

Specified by:

flushBeforeTransactionCompletion in interface JdbcSessionOwner

getEntityManagerFactory

public EntityManagerFactory getEntityManagerFactory()

Description copied from interface: EntityManager

Return the entity manager factory for the entity manager.

Specified by:

getEntityManagerFactory in interface EntityManager

Returns:

EntityManagerFactory instance

getCriteriaBuilder

public HibernateCriteriaBuilder getCriteriaBuilder()

Description copied from interface: SharedSessionContract

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

Specified by:

getCriteriaBuilder in interface EntityManager

Specified by:

getCriteriaBuilder in interface SharedSessionContract

Returns:

an instance of HibernateCriteriaBuilder

See Also:

• SessionFactory.getCriteriaBuilder()

getMetamodel

public Metamodel getMetamodel()

Description copied from interface: EntityManager

Return an instance of Metamodel interface for access to the metamodel of the persistence unit.

Specified by:

getMetamodel in interface EntityManager

Returns:

Metamodel instance

createEntityGraph

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

Description copied from interface: SharedSessionContract

Create a new mutable EntityGraph with only a root node.

Specified by:

createEntityGraph in interface EntityManager

Specified by:

createEntityGraph in interface Session

Specified by:

createEntityGraph in interface SessionImplementor

Specified by:

createEntityGraph in interface SharedSessionContract

Parameters:

rootType - the root entity class of the graph

Returns:

entity graph

createEntityGraph

public RootGraphImplementor<?> createEntityGraph(String graphName)

Description copied from interface: SharedSessionContract

Create a new mutable copy of the named EntityGraph, or return null if there is no graph with the given name.

Specified by:

createEntityGraph in interface EntityManager

Specified by:

createEntityGraph in interface Session

Specified by:

createEntityGraph in interface SessionImplementor

Specified by:

createEntityGraph in interface SharedSessionContract

Parameters:

graphName - the name of the graph

Returns:

entity graph

See Also:

• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)

createEntityGraph

public <T> RootGraph<T> createEntityGraph(Class<T> rootType,
 String graphName)

Description copied from interface: SharedSessionContract

Create a new mutable copy of the named EntityGraph, or return null if there is no graph with the given name.

Specified by:

createEntityGraph in interface SharedSessionContract

Parameters:

rootType - the root entity class of the graph

graphName - the name of the graph

See Also:

• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)

getEntityGraph

public RootGraphImplementor<?> getEntityGraph(String graphName)

Description copied from interface: SharedSessionContract

Retrieve the named EntityGraph as an immutable graph, or return null if there is no graph with the given name.

Specified by:

getEntityGraph in interface EntityManager

Specified by:

getEntityGraph in interface Session

Specified by:

getEntityGraph in interface SessionImplementor

Specified by:

getEntityGraph in interface SharedSessionContract

Parameters:

graphName - the name of the graph

Returns:

named entity graph

See Also:

• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)

getEntityGraphs

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

Description copied from interface: SharedSessionContract

Retrieve all named EntityGraphs with the given type.

Specified by:

getEntityGraphs in interface EntityManager

Specified by:

getEntityGraphs in interface Session

Specified by:

getEntityGraphs in interface SharedSessionContract

Parameters:

entityClass - entity class

Returns:

list of all entity graphs defined for the entity

See Also:

• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)

createMutationQuery

public MutationQuery createMutationQuery(CriteriaUpdate updateQuery)

Description copied from interface: QueryProducer

Create a MutationQuery from the given update criteria tree

Specified by:

createMutationQuery in interface QueryProducer

Specified by:

createMutationQuery in interface QueryProducerImplementor

createMutationQuery

public MutationQuery createMutationQuery(CriteriaDelete deleteQuery)

Description copied from interface: QueryProducer

Create a MutationQuery from the given delete criteria tree

Specified by:

createMutationQuery in interface QueryProducer

Specified by:

createMutationQuery in interface QueryProducerImplementor

createMutationQuery

public MutationQuery createMutationQuery(JpaCriteriaInsertSelect insertSelect)

Description copied from interface: QueryProducer

Create a MutationQuery from the given insert-select criteria tree

Specified by:

createMutationQuery in interface QueryProducer

createMutationQuery

public MutationQuery createMutationQuery(JpaCriteriaInsert insertSelect)

Description copied from interface: QueryProducer

Create a MutationQuery from the given insert criteria tree

Specified by:

createMutationQuery in interface QueryProducer

createQuery

public <T> QueryImplementor<T> createQuery(CriteriaQuery<T> criteriaQuery)

Description copied from interface: QueryProducer

Create a Query for the given JPA CriteriaQuery.

Specified by:

createQuery in interface EntityManager

Specified by:

createQuery in interface QueryProducer

Specified by:

createQuery in interface QueryProducerImplementor

Specified by:

createQuery in interface Session

Parameters:

criteriaQuery - a criteria query object

Returns:

the new query instance

createQuery

public QueryImplementor createQuery(CriteriaUpdate updateQuery)

Description copied from interface: Session

Create a Query for the given JPA CriteriaUpdate.

Specified by:

createQuery in interface EntityManager

Specified by:

createQuery in interface QueryProducer

Specified by:

createQuery in interface QueryProducerImplementor

Specified by:

createQuery in interface Session

Parameters:

updateQuery - a criteria update query object

Returns:

the new query instance

createQuery

public QueryImplementor createQuery(CriteriaDelete deleteQuery)

Description copied from interface: Session

Create a Query for the given JPA CriteriaDelete.

Specified by:

createQuery in interface EntityManager

Specified by:

createQuery in interface QueryProducer

Specified by:

createQuery in interface QueryProducerImplementor

Specified by:

createQuery in interface Session

Parameters:

deleteQuery - a criteria delete query object

Returns:

the new query instance

getNamedQuery

public QueryImplementor getNamedQuery(String name)

Description copied from interface: QueryProducer

Create a Query instance for the named query.

Specified by:

getNamedQuery in interface QueryProducer

Specified by:

getNamedQuery in interface QueryProducerImplementor

Parameters:

name - the name of a predefined named query

Returns:

The Query instance for manipulation and execution

getNamedNativeQuery

public NativeQueryImplementor getNamedNativeQuery(String name)

Description copied from interface: QueryProducer

Get a NativeQuery instance for a named native SQL query

Specified by:

getNamedNativeQuery in interface QueryProducer

Specified by:

getNamedNativeQuery in interface QueryProducerImplementor

Parameters:

name - The name of the predefined query

Returns:

The NativeQuery instance for manipulation and execution

getNamedNativeQuery

public NativeQueryImplementor getNamedNativeQuery(String name,
 String resultSetMapping)

Description copied from interface: QueryProducer

Get a NativeQuery instance for a named native SQL query

Specified by:

getNamedNativeQuery in interface QueryProducer

Specified by:

getNamedNativeQuery in interface QueryProducerImplementor

Parameters:

name - The name of the predefined query

Returns:

The NativeQuery instance for manipulation and execution

createQuery

public QueryImplementor createQuery(String queryString)

Description copied from interface: QueryProducer

Create a Query instance for the given HQL query, or HQL insert, update, or delete statement.

If a query has no explicit select list, the select list is inferred:

• if there is exactly one root entity in the from clause, then that root entity is the only element of the select list, or
• otherwise, if there are multiple root entities in the from clause, then the select list contains every root entity and every non-fetch joined entity.

Specified by:

createQuery in interface EntityManager

Specified by:

createQuery in interface QueryProducer

Specified by:

createQuery in interface QueryProducerImplementor

Specified by:

createQuery in interface Session

Parameters:

queryString - The HQL query

Returns:

The Query instance for manipulation and execution

See Also:

• EntityManager.createQuery(String)

createSelectionQuery

public SelectionQuery<?> createSelectionQuery(String hqlString)

Description copied from interface: QueryProducer

Create a SelectionQuery reference for the given HQL select statement.

If the statement has no explicit select list, the select list is inferred:

• if there is exactly one root entity in the from clause, then that root entity is the only element of the select list, or
• otherwise, if there are multiple root entities in the from clause, then the select list contains every root entity and every non-fetch joined entity.

Specified by:

createSelectionQuery in interface QueryProducer

createSelectionQuery

public <R> SelectionQuery<R> createSelectionQuery(String hqlString,
 Class<R> resultType)

Description copied from interface: QueryProducer

Create a SelectionQuery instance for the given HQL query string and given query result type.

• If the query has a single item in the select list, then the select item must be assignable to the given result type.
• Otherwise, if there are multiple select items, then the select items will be packaged into an instance of the result type. The result type must have an appropriate constructor with parameter types matching the select items, or it must be one of the types Object[], List, Map, or Tuple.

If a query has no explicit select list, the select list is inferred from the given query result type:

• if the result type is an entity type, the query must have exactly one root entity in the from clause, it must be assignable to the result type, and the inferred select list will contain just that entity, or
• otherwise, the select list contains every root entity and every non-fetch joined entity, and each query result will be packaged into an instance of the result type, just as specified above.

The returned Query may be executed by calling Query.getResultList() or Query.getSingleResult().

Specified by:

createSelectionQuery in interface QueryProducer

Parameters:

hqlString - The HQL query as a string

resultType - The Class object representing the query result type

See Also:

• EntityManager.createQuery(String)

createSelectionQuery

public <R> SelectionQuery<R> createSelectionQuery(CriteriaQuery<R> criteria)

Description copied from interface: QueryProducer

Create a SelectionQuery reference for the given CriteriaQuery.

Specified by:

createSelectionQuery in interface QueryProducer

See Also:

• EntityManager.createQuery(CriteriaQuery)

createQuery

public <T> QueryImplementor<T> createQuery(String queryString,
 Class<T> resultType)

Description copied from interface: QueryProducer

Create a typed Query instance for the given HQL query string and given query result type.

• If the query has a single item in the select list, then the select item must be assignable to the given result type.
• Otherwise, if there are multiple select items, then the select items will be packaged into an instance of the result type. The result type must have an appropriate constructor with parameter types matching the select items, or it must be one of the types Object[], List, Map, or Tuple.

If a query has no explicit select list, the select list is inferred from the given query result type:

• if the result type is an entity type, the query must have exactly one root entity in the from clause, it must be assignable to the result type, and the inferred select list will contain just that entity, or
• otherwise, the select list contains every root entity and every non-fetch joined entity, and each query result will be packaged into an instance of the result type, just as specified above.

The returned Query may be executed by calling Query.getResultList() or Query.getSingleResult().

Specified by:

createQuery in interface EntityManager

Specified by:

createQuery in interface QueryProducer

Specified by:

createQuery in interface QueryProducerImplementor

Specified by:

createQuery in interface Session

Parameters:

queryString - The HQL query

resultType - The type of the query result

Returns:

The Query instance for manipulation and execution

See Also:

• EntityManager.createQuery(String,Class)

createNamedQuery

public QueryImplementor createNamedQuery(String name)

Description copied from interface: QueryProducer

Create a typed Query instance for the given named query. The named query might be defined in HQL or in native SQL.

Specified by:

createNamedQuery in interface EntityManager

Specified by:

createNamedQuery in interface QueryProducer

Specified by:

createNamedQuery in interface QueryProducerImplementor

Specified by:

createNamedQuery in interface Session

Parameters:

name - the name of a predefined named query

Returns:

The Query instance for manipulation and execution

See Also:

• EntityManager.createNamedQuery(String)

createNamedQuery

public <T> QueryImplementor<T> createNamedQuery(String name,
 Class<T> resultClass)

Description copied from interface: QueryProducer

Create a typed Query instance for the given named query. The named query might be defined in HQL or in native SQL.

Specified by:

createNamedQuery in interface EntityManager

Specified by:

createNamedQuery in interface QueryProducer

Specified by:

createNamedQuery in interface QueryProducerImplementor

Specified by:

createNamedQuery in interface Session

Parameters:

name - the name of a query defined in metadata

resultClass - the type of the query result

Returns:

The Query instance for manipulation and execution

See Also:

• EntityManager.createNamedQuery(String,Class)

createNamedSelectionQuery

public SelectionQuery<?> createNamedSelectionQuery(String name)

Description copied from interface: QueryProducer

Create a SelectionQuery instance for the named NamedQuery.

Specified by:

createNamedSelectionQuery in interface QueryProducer

createNamedSelectionQuery

public <R> SelectionQuery<R> createNamedSelectionQuery(String name,
 Class<R> resultType)

Description copied from interface: QueryProducer

Create a SelectionQuery instance for the named NamedQuery with the given result type.

Specified by:

createNamedSelectionQuery in interface QueryProducer

createNativeQuery

public NativeQueryImplementor createNativeQuery(String sqlString)

Description copied from interface: QueryProducer

Create a NativeQuery instance for the given native SQL query.

Specified by:

createNativeQuery in interface EntityManager

Specified by:

createNativeQuery in interface QueryProducer

Specified by:

createNativeQuery in interface QueryProducerImplementor

Parameters:

sqlString - a native SQL query string

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String)

createNativeQuery

public NativeQueryImplementor createNativeQuery(String sqlString,
 Class resultClass)

Description copied from interface: QueryProducer

Create a NativeQuery instance for the given native SQL query using an implicit mapping to the specified Java type.

• If the given class is an entity class, this method is equivalent to createNativeQuery(sqlString).addEntity(resultClass).
• If the given class has a registered JavaType, then the query must return a result set with a single column whose JdbcType is compatible with that JavaType.
• Otherwise, the select items will be packaged into an instance of the result type. The result type must have an appropriate constructor with parameter types matching the select items, or it must be one of the types Object[], List, Map, or Tuple.

Specified by:

createNativeQuery in interface EntityManager

Specified by:

createNativeQuery in interface QueryProducer

Specified by:

createNativeQuery in interface QueryProducerImplementor

Parameters:

sqlString - The native (SQL) query string

resultClass - The Java type to map results to

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String,Class)

createNativeQuery

public <T> NativeQueryImplementor<T> createNativeQuery(String sqlString,
 Class<T> resultClass,
 String tableAlias)

Description copied from interface: QueryProducer

Create a NativeQuery instance for the given native SQL query using an implicit mapping to the specified Java entity type.

The given class must be an entity class. This method is equivalent to createNativeQuery(sqlString).addEntity(tableAlias, resultClass).

Specified by:

createNativeQuery in interface QueryProducer

Specified by:

createNativeQuery in interface QueryProducerImplementor

Parameters:

sqlString - Native (SQL) query string

resultClass - The Java entity class to map results to

tableAlias - The table alias for columns in the result set

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String,Class)

createNativeQuery

public NativeQueryImplementor createNativeQuery(String sqlString,
 String resultSetMappingName)

Description copied from interface: QueryProducer

Create a NativeQuery instance for the given native SQL query using an explicit mapping to the specified Java type.

The given result set mapping name must identify a mapping defined by a SqlResultSetMapping annotation.

Specified by:

createNativeQuery in interface EntityManager

Specified by:

createNativeQuery in interface QueryProducer

Specified by:

createNativeQuery in interface QueryProducerImplementor

Parameters:

sqlString - The native (SQL) query string

resultSetMappingName - The explicit result mapping name

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String,Class)
• SqlResultSetMapping

createNativeQuery

public <T> NativeQueryImplementor<T> createNativeQuery(String sqlString,
 String resultSetMappingName,
 Class<T> resultClass)

Description copied from interface: QueryProducer

Create a NativeQuery instance for the given native SQL query using an explicit mapping to the specified Java type.

The given result set mapping name must identify a mapping defined by a SqlResultSetMapping annotation.

Specified by:

createNativeQuery in interface QueryProducer

Specified by:

createNativeQuery in interface QueryProducerImplementor

Parameters:

sqlString - The native (SQL) query string

resultSetMappingName - The explicit result mapping name

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String,Class)
• SqlResultSetMapping

createMutationQuery

public MutationQuery createMutationQuery(String statementString)

Description copied from interface: QueryProducer

Create a MutationQuery reference for the given HQL insert, update, or delete statement.

Specified by:

createMutationQuery in interface QueryProducer

Specified by:

createMutationQuery in interface QueryProducerImplementor

createNamedMutationQuery

public MutationQuery createNamedMutationQuery(String name)

Description copied from interface: QueryProducer

Create a MutationQuery instance for the given named insert, update, or delete HQL query. The named query might be defined as HQL) or native-SQL.

Specified by:

createNamedMutationQuery in interface QueryProducer

Specified by:

createNamedMutationQuery in interface QueryProducerImplementor

createNativeMutationQuery

public MutationQuery createNativeMutationQuery(String sqlString)

Description copied from interface: QueryProducer

Create a NativeQuery instance for the given native SQL statement.

Specified by:

createNativeMutationQuery in interface QueryProducer

Specified by:

createNativeMutationQuery in interface QueryProducerImplementor

Parameters:

sqlString - a native SQL statement string

Returns:

The NativeQuery instance for manipulation and execution

createNamedStoredProcedureQuery

public ProcedureCall createNamedStoredProcedureQuery(String name)

Description copied from interface: SharedSessionContract

Obtain a ProcedureCall based on a named template

Specified by:

createNamedStoredProcedureQuery in interface EntityManager

Specified by:

createNamedStoredProcedureQuery in interface SharedSessionContract

Parameters:

name - The name given to the template

Returns:

The ProcedureCall

See Also:

• NamedStoredProcedureQuery

createStoredProcedureQuery

public ProcedureCall createStoredProcedureQuery(String procedureName)

Description copied from interface: SharedSessionContract

Create a ProcedureCall to a stored procedure.

Specified by:

createStoredProcedureQuery in interface EntityManager

Specified by:

createStoredProcedureQuery in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

Returns:

The representation of the procedure call.

createStoredProcedureQuery

public ProcedureCall createStoredProcedureQuery(String procedureName,
 Class... resultClasses)

Description copied from interface: SharedSessionContract

Create a ProcedureCall to a stored procedure with the given result set entity mappings. Each given class is considered a "root return".

Specified by:

createStoredProcedureQuery in interface EntityManager

Specified by:

createStoredProcedureQuery in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

resultClasses - The entity(s) to map the result on to.

Returns:

The representation of the procedure call.

createStoredProcedureQuery

public ProcedureCall createStoredProcedureQuery(String procedureName,
 String... resultSetMappings)

Description copied from interface: SharedSessionContract

Create a ProcedureCall to a stored procedure with the given result set entity mappings.

Specified by:

createStoredProcedureQuery in interface EntityManager

Specified by:

createStoredProcedureQuery in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

resultSetMappings - The explicit result set mapping(s) to use for mapping the results

Returns:

The representation of the procedure call.

prepareForQueryExecution

public void prepareForQueryExecution(boolean requiresTxn)

Description copied from interface: SharedSessionContractImplementor

Prepare for the execution of a Query or ProcedureCall

Specified by:

prepareForQueryExecution in interface SharedSessionContractImplementor

joinTransaction

public void joinTransaction()

Description copied from interface: SharedSessionContract

Join the currently-active JTA transaction.

Specified by:

joinTransaction in interface EntityManager

Specified by:

joinTransaction in interface SharedSessionContract

See Also:

• EntityManager.joinTransaction()

isJoinedToTransaction

public boolean isJoinedToTransaction()

Description copied from interface: SharedSessionContract

Check if the session is joined to the current transaction.

Specified by:

isJoinedToTransaction in interface EntityManager

Specified by:

isJoinedToTransaction in interface SharedSessionContract

Returns:

boolean

See Also:

• SharedSessionContract.joinTransaction()
• EntityManager.isJoinedToTransaction()

unwrap

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

Description copied from interface: EntityManager

Return an object of the specified type to allow access to the provider-specific API. If the provider's EntityManager implementation does not support the specified class, the PersistenceException is thrown.

Specified by:

unwrap in interface EntityManager

Parameters:

cls - the class of the object to be returned. This is normally either the underlying EntityManager implementation class or an interface that it implements.

Returns:

an instance of the specified class

getDelegate

public Object getDelegate()

This is the implementation of EntityManager.getDelegate(). It returns this object and not what we call the "delegate" session here. To get the delegate session, use delegate() instead.

Specified by:

getDelegate in interface EntityManager

Returns:

underlying provider object for EntityManager

See Also:

• delegate()

getNamedProcedureCall

public ProcedureCall getNamedProcedureCall(String name)

Description copied from interface: SharedSessionContract

Obtain a ProcedureCall based on a named template

Specified by:

getNamedProcedureCall in interface SharedSessionContract

Parameters:

name - The name given to the template

Returns:

The ProcedureCall

See Also:

• NamedStoredProcedureQuery

createStoredProcedureCall

public ProcedureCall createStoredProcedureCall(String procedureName)

Description copied from interface: SharedSessionContract

Create a ProcedureCall to a stored procedure.

Specified by:

createStoredProcedureCall in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

Returns:

The representation of the procedure call.

createStoredProcedureCall

public ProcedureCall createStoredProcedureCall(String procedureName,
 Class<?>... resultClasses)

Description copied from interface: SharedSessionContract

Create a ProcedureCall to a stored procedure with the given result set entity mappings. Each given class is considered a "root return".

Specified by:

createStoredProcedureCall in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

resultClasses - The entity(s) to map the result on to.

Returns:

The representation of the procedure call.

createStoredProcedureCall

public ProcedureCall createStoredProcedureCall(String procedureName,
 String... resultSetMappings)

Description copied from interface: SharedSessionContract

Create a ProcedureCall to a stored procedure with the given result set entity mappings.

Specified by:

createStoredProcedureCall in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

resultSetMappings - The explicit result set mapping(s) to use for mapping the results

Returns:

The representation of the procedure call.

sessionWithOptions

public SharedSessionBuilder sessionWithOptions()

Description copied from interface: Session

Obtain a Session builder with the ability to copy certain information from this session.

Specified by:

sessionWithOptions in interface Session

Returns:

the session builder

getSessionFactory

public SessionFactoryImplementor getSessionFactory()

Description copied from interface: Session

Get the session factory which created this session.

Specified by:

getSessionFactory in interface Session

Specified by:

getSessionFactory in interface SessionImplementor

Specified by:

getSessionFactory in interface SharedSessionContractImplementor

Specified by:

getSessionFactory in interface WrapperOptions

Returns:

the session factory

See Also:

• SessionFactory

close

public void close()
           throws HibernateException

Description copied from interface: SharedSessionContract

End the session by releasing the JDBC connection and cleaning up.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in interface EntityManager

Specified by:

close in interface SharedSessionContract

Throws:

HibernateException - Indicates problems cleaning up.

cancelQuery

public void cancelQuery()
                 throws HibernateException

Description copied from interface: Session

Cancel the execution of the current query.

This is the sole method on session which may be safely called from another thread.

Specified by:

cancelQuery in interface Session

Throws:

HibernateException - if there was a problem cancelling the query

isDirty

public boolean isDirty()
                throws HibernateException

Description copied from interface: Session

Does this session contain any changes which must be synchronized with the database? In other words, would any DML operations be executed if we flushed this session?

Specified by:

isDirty in interface Session

Returns:

true if the session contains pending changes; false otherwise.

Throws:

HibernateException - could not perform dirtying checking

isDefaultReadOnly

public boolean isDefaultReadOnly()

Description copied from interface: Session

Will entities and proxies that are loaded into this session be made read-only by default?

To determine the read-only/modifiable setting for a particular entity or proxy use Session.isReadOnly(Object).

Specified by:

isDefaultReadOnly in interface Session

Specified by:

isDefaultReadOnly in interface SharedSessionContractImplementor

Returns:

true, loaded entities/proxies will be made read-only by default; false, loaded entities/proxies will be made modifiable by default.

See Also:

• Session.isReadOnly(Object)

setDefaultReadOnly

public void setDefaultReadOnly(boolean readOnly)

Description copied from interface: Session

Change the default for entities and proxies loaded into this session from modifiable to read-only mode, or from modifiable to read-only mode.

Read-only entities are not dirty-checked and snapshots of persistent state are not maintained. Read-only entities can be modified, but changes are not persisted.

When a proxy is initialized, the loaded entity will have the same read-only/modifiable setting as the uninitialized proxy has, regardless of the session's current setting.

To change the read-only/modifiable setting for a particular entity or proxy that already belongs to this session use Session.setReadOnly(Object, boolean).

To override this session's read-only/modifiable setting for all entities and proxies loaded by a certain Query use Query.setReadOnly(boolean).

Specified by:

setDefaultReadOnly in interface Session

Parameters:

readOnly - true, the default for loaded entities/proxies is read-only; false, the default for loaded entities/proxies is modifiable

See Also:

• Session.setReadOnly(Object,boolean)
• Query.setReadOnly(boolean)

getIdentifier

public Object getIdentifier(Object object)

Description copied from interface: Session

Return the identifier value of the given entity associated with this session. An exception is thrown if the given entity instance is transient or detached in relation to this session.

Specified by:

getIdentifier in interface Session

Parameters:

object - a persistent instance associated with this session

Returns:

the identifier

contains

public boolean contains(String entityName,
 Object object)

Description copied from interface: Session

Determine if the given entity is associated with this session.

Specified by:

contains in interface Session

Parameters:

entityName - the entity name

object - an instance of a persistent class

Returns:

true if the given instance is associated with this Session

contains

public boolean contains(Object object)

Description copied from interface: EntityManager

Check if the instance is a managed entity instance belonging to the current persistence context.

Specified by:

contains in interface EntityManager

Parameters:

object - entity instance

Returns:

boolean indicating if entity is in persistence context

getLockMode

public LockModeType getLockMode(Object entity)

Description copied from interface: EntityManager

Get the current lock mode for the entity instance.

Specified by:

getLockMode in interface EntityManager

Parameters:

entity - entity instance

Returns:

lock mode

setProperty

public void setProperty(String propertyName,
 Object value)

Description copied from interface: EntityManager

Set an entity manager property or hint. If a vendor-specific property or hint is not recognized, it is silently ignored.

Specified by:

setProperty in interface EntityManager

Parameters:

propertyName - name of property or hint

value - value for property or hint

getProperties

public Map<String,Object> getProperties()

Description copied from interface: EntityManager

Get the properties and hints and associated values that are in effect for the entity manager. Changing the contents of the map does not change the configuration in effect.

Specified by:

getProperties in interface EntityManager

Returns:

map of properties and hints in effect for entity manager

evict

public void evict(Object object)

Description copied from interface: Session

Remove this instance from the session cache. Changes to the instance will not be synchronized with the database. This operation cascades to associated instances if the association is mapped with CascadeType.DETACH.

This operation is a synonym for Session.detach(Object).

Specified by:

evict in interface Session

Parameters:

object - the managed entity to evict

load

public <T> T load(Class<T> theClass,
 Object id,
 LockMode lockMode)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.

Convenient form of Session.load(Class, Object, LockOptions).

Specified by:

load in interface Session

Parameters:

theClass - a persistent class

id - a valid identifier of an existing persistent instance of the class

lockMode - the lock level

Returns:

the persistent instance or proxy

See Also:

• Session.load(Class, Object, LockOptions)

load

public <T> T load(Class<T> theClass,
 Object id,
 LockOptions lockOptions)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.

Specified by:

load in interface Session

Parameters:

theClass - a persistent class

id - a valid identifier of an existing persistent instance of the class

lockOptions - contains the lock level

Returns:

the persistent instance or proxy

load

public Object load(String entityName,
 Object id,
 LockMode lockMode)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.

Convenient form of Session.load(String, Object, LockOptions).

Specified by:

load in interface Session

Parameters:

entityName - the entity name

id - a valid identifier of an existing persistent instance of the class

lockMode - the lock level

Returns:

the persistent instance or proxy

See Also:

• Session.load(String, Object, LockOptions)

load

public Object load(String entityName,
 Object id,
 LockOptions lockOptions)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.

Specified by:

load in interface Session

Parameters:

entityName - the entity name

id - a valid identifier of an existing persistent instance of the class

lockOptions - contains the lock level

Returns:

the persistent instance or proxy

load

public <T> T load(Class<T> theClass,
 Object id)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, making the assumption that the instance exists in the database. This method might return a proxied instance that is initialized on-demand, when a non-identifier method is accessed.

You should not use this method to determine if an instance exists in the database (use get() instead). Use this only to retrieve an instance that you assume exists, where non-existence would be an actual error.

This operation is very similar to Session.getReference(Class, Object).

Specified by:

load in interface Session

Parameters:

theClass - a persistent class

id - a valid identifier of an existing persistent instance of the class

Returns:

the persistent instance or proxy

load

public Object load(String entityName,
 Object id)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, making the assumption that the instance exists in the database. This method might return a proxied instance that is initialized on-demand, when a non-identifier method is accessed.

You should not use this method to determine if an instance exists in the database (use get() instead). Use this only to retrieve an instance that you assume exists, where non-existence would be an actual error.

Specified by:

load in interface Session

Parameters:

entityName - the entity name

id - a valid identifier of an existing persistent instance of the class

Returns:

the persistent instance or proxy

load

public void load(Object object,
 Object id)

Description copied from interface: Session

Read the persistent state associated with the given identifier into the given transient instance.

Specified by:

load in interface Session

replicate

public void replicate(Object object,
 ReplicationMode replicationMode)

Description copied from interface: Session

Persist the state of the given detached instance, reusing the current identifier value. This operation cascades to associated instances if the association is mapped with CascadeType.REPLICATE.

Specified by:

replicate in interface Session

Parameters:

object - a detached instance of a persistent class

replicationMode - the replication mode to use

replicate

public void replicate(String entityName,
 Object object,
 ReplicationMode replicationMode)

Description copied from interface: Session

Persist the state of the given detached instance, reusing the current identifier value. This operation cascades to associated instances if the association is mapped with CascadeType.REPLICATE.

Specified by:

replicate in interface Session

Parameters:

entityName - the entity name

object - a detached instance of a persistent class

replicationMode - the replication mode to use

save

public Object save(Object object)

Description copied from interface: Session

Persist the given transient instance, first assigning a generated identifier. (Or using the current value of the identifier property if the assigned generator is used.) This operation cascades to associated instances if the association is mapped with CascadeType.SAVE_UPDATE.

This operation is very similar to Session.persist(Object).

Specified by:

save in interface Session

Parameters:

object - a transient instance of a persistent class

Returns:

the generated identifier

save

public Object save(String entityName,
 Object object)

Description copied from interface: Session

Persist the given transient instance, first assigning a generated identifier. (Or using the current value of the identifier property if the assigned generator is used.) This operation cascades to associated instances if the association is mapped with CascadeType.SAVE_UPDATE.

Specified by:

save in interface Session

Parameters:

entityName - the entity name

object - a transient instance of a persistent class

Returns:

the generated identifier

saveOrUpdate

public void saveOrUpdate(Object object)

Description copied from interface: Session

Either Session.save(Object) or Session.update(Object) the given instance, depending upon resolution of the unsaved-value checks (see the manual for discussion of unsaved-value checking).

This operation cascades to associated instances if the association is mapped with CascadeType.SAVE_UPDATE.

Specified by:

saveOrUpdate in interface Session

Parameters:

object - a transient or detached instance containing new or updated state

See Also:

• Session.save(Object)
• Session.update(Object object)

saveOrUpdate

public void saveOrUpdate(String entityName,
 Object object)

Description copied from interface: Session

Either Session.save(String, Object) or Session.update(String, Object) the given instance, depending upon resolution of the unsaved-value checks (see the manual for discussion of unsaved-value checking).

This operation cascades to associated instances if the association is mapped with CascadeType.SAVE_UPDATE.

Specified by:

saveOrUpdate in interface Session

Parameters:

entityName - the entity name

object - a transient or detached instance containing new or updated state

See Also:

• Session.save(String,Object)
• Session.update(String,Object)

update

public void update(Object object)

Description copied from interface: Session

Update the persistent instance with the identifier of the given detached instance. If there is a persistent instance with the same identifier, an exception is thrown. This operation cascades to associated instances if the association is mapped with CascadeType.SAVE_UPDATE.

Specified by:

update in interface Session

Parameters:

object - a detached instance containing updated state

update

public void update(String entityName,
 Object object)

Description copied from interface: Session

Update the persistent instance with the identifier of the given detached instance. If there is a persistent instance with the same identifier, an exception is thrown. This operation cascades to associated instances if the association is mapped with CascadeType.SAVE_UPDATE.

Specified by:

update in interface Session

Parameters:

entityName - the entity name

object - a detached instance containing updated state

merge

public <T> T merge(T object)

Description copied from interface: Session

Copy the state of the given object onto the persistent object with the same identifier. If there is no persistent instance currently associated with the session, it will be loaded. Return the persistent instance. If the given instance is unsaved, save a copy and return it as a newly persistent instance. The given instance does not become associated with the session. This operation cascades to associated instances if the association is mapped with CascadeType.MERGE.

Specified by:

merge in interface EntityManager

Specified by:

merge in interface Session

Parameters:

object - a detached instance with state to be copied

Returns:

an updated persistent instance

merge

public <T> T merge(String entityName,
 T object)

Description copied from interface: Session

Copy the state of the given object onto the persistent object with the same identifier. If there is no persistent instance currently associated with the session, it will be loaded. Return the persistent instance. If the given instance is unsaved, save a copy and return it as a newly persistent instance. The given instance does not become associated with the session. This operation cascades to associated instances if the association is mapped with CascadeType.MERGE.

Specified by:

merge in interface Session

Parameters:

entityName - the entity name

object - a detached instance with state to be copied

Returns:

an updated persistent instance

persist

public void persist(Object object)

Description copied from interface: Session

Make a transient instance persistent and mark it for later insertion in the database. This operation cascades to associated instances if the association is mapped with CascadeType.PERSIST.

For an entity with a generated id, persist() ultimately results in generation of an identifier for the given instance. But this may happen asynchronously, when the session is flushed, depending on the identifier generation strategy.

Specified by:

persist in interface EntityManager

Specified by:

persist in interface Session

Parameters:

object - a transient instance to be made persistent

remove

public void remove(Object entity)

Description copied from interface: Session

Mark a persistence instance associated with this session for removal from the underlying database. Ths operation cascades to associated instances if the association is mapped CascadeType.REMOVE.

Specified by:

remove in interface EntityManager

Specified by:

remove in interface Session

Parameters:

entity - the managed persistent instance to remove

find

public <T> @Nullable T find(Class<T> entityClass,
 Object primaryKey)

Description copied from interface: EntityManager

Find by primary key. Search for an entity of the specified class and primary key. If the entity instance is contained in the persistence context, it is returned from there.

Specified by:

find in interface EntityManager

Parameters:

entityClass - entity class

primaryKey - primary key

Returns:

the found entity instance or null if the entity does not exist

find

public <T> @Nullable T find(Class<T> entityClass,
 Object primaryKey,
 Map<String,Object> properties)

Description copied from interface: EntityManager

Find by primary key, using the specified properties. Search for an entity of the specified class and primary key. If the entity instance is contained in the persistence context, it is returned from there. If a vendor-specific property or hint is not recognized, it is silently ignored.

Specified by:

find in interface EntityManager

Parameters:

entityClass - entity class

primaryKey - primary key

properties - standard and vendor-specific properties and hints

Returns:

the found entity instance or null if the entity does not exist

find

public <T> @Nullable T find(Class<T> entityClass,
 Object primaryKey,
 LockModeType lockMode)

Description copied from interface: EntityManager

Find by primary key and lock. Search for an entity of the specified class and primary key and lock it with respect to the specified lock type. If the entity instance is contained in the persistence context, it is returned from there, and the effect of this method is the same as if the lock method had been called on the entity.

If the entity is found within the persistence context and the lock mode type is pessimistic and the entity has a version attribute, the persistence provider must perform optimistic version checks when obtaining the database lock. If these checks fail, the OptimisticLockException will be thrown.

If the lock mode type is pessimistic and the entity instance is found but cannot be locked:

• the PessimisticLockException will be thrown if the database locking failure causes transaction-level rollback
• the LockTimeoutException will be thrown if the database locking failure causes only statement-level rollback

Specified by:

find in interface EntityManager

Parameters:

entityClass - entity class

primaryKey - primary key

lockMode - lock mode

Returns:

the found entity instance or null if the entity does not exist

find

public <T> @Nullable T find(Class<T> entityClass,
 Object primaryKey,
 LockModeType lockMode,
 Map<String,Object> properties)

Description copied from interface: EntityManager

Find by primary key and lock, using the specified properties. Search for an entity of the specified class and primary key and lock it with respect to the specified lock type. If the entity instance is contained in the persistence context, it is returned from there.

If the entity is found within the persistence context and the lock mode type is pessimistic and the entity has a version attribute, the persistence provider must perform optimistic version checks when obtaining the database lock. If these checks fail, the OptimisticLockException will be thrown.

If the lock mode type is pessimistic and the entity instance is found but cannot be locked:

• the PessimisticLockException will be thrown if the database locking failure causes transaction-level rollback
• the LockTimeoutException will be thrown if the database locking failure causes only statement-level rollback

If a vendor-specific property or hint is not recognized, it is silently ignored.

Portable applications should not rely on the standard timeout hint. Depending on the database in use and the locking mechanisms used by the provider, the hint may or may not be observed.

Specified by:

find in interface EntityManager

Parameters:

entityClass - entity class

primaryKey - primary key

lockMode - lock mode

properties - standard and vendor-specific properties and hints

Returns:

the found entity instance or null if the entity does not exist

getReference

public <T> T getReference(Class<T> entityClass,
 Object id)

Description copied from interface: Session

Return a reference to the persistent instance with the given class and identifier, making the assumption that the instance is still persistent in the database. This method never results in access to the underlying data store, and thus might return a proxy that is initialized on-demand, when a non-identifier method is accessed.

Note that Hibernate.createDetachedProxy(SessionFactory, Class, Object) may be used to obtain a detached reference.

It's sometimes necessary to narrow a reference returned by getReference() to a subtype of the given entity type. A direct Java typecast should never be used in this situation. Instead, the method Hibernate.unproxy(Object, Class) is the recommended way to narrow the type of a proxy object. Alternatively, a new reference may be obtained by simply calling getReference() again, passing the subtype. Either way, the narrowed reference will usually not be identical to the original reference, when the references are compared using the == operator.

Specified by:

getReference in interface EntityManager

Specified by:

getReference in interface Session

Parameters:

entityClass - the entity type

id - the identifier of a persistent instance that exists in the database

Returns:

the persistent instance or proxy

getReference

public Object getReference(String entityName,
 Object id)

Description copied from interface: Session

Return a reference to the persistent instance of the given named entity with the given identifier, making the assumption that the instance is still persistent in the database. This method never results in access to the underlying data store, and thus might return a proxy that is initialized on-demand, when a non-identifier method is accessed.

Specified by:

getReference in interface Session

Parameters:

entityName - the entity name

id - the identifier of a persistent instance that exists in the database

Returns:

the persistent instance or proxy

persist

public void persist(String entityName,
 Object object)

Description copied from interface: Session

Make a transient instance persistent and mark it for later insertion in the database. This operation cascades to associated instances if the association is mapped with CascadeType.PERSIST.

For entities with a generated id, persist() ultimately results in generation of an identifier for the given instance. But this may happen asynchronously, when the session is flushed, depending on the identifier generation strategy.

Specified by:

persist in interface Session

Parameters:

entityName - the entity name

object - a transient instance to be made persistent

delete

public void delete(Object object)

Description copied from interface: Session

Remove a persistent instance from the datastore. The argument may be an instance associated with the receiving Session or a transient instance with an identifier associated with existing persistent state. This operation cascades to associated instances if the association is mapped with CascadeType.REMOVE.

Specified by:

delete in interface Session

Parameters:

object - the instance to be removed

delete

public void delete(String entityName,
 Object object)

Description copied from interface: Session

Remove a persistent instance from the datastore. The second argument may be an instance associated with the receiving Session or a transient instance with an identifier associated with existing persistent state. This operation cascades to associated instances if the association is mapped with CascadeType.REMOVE.

Specified by:

delete in interface Session

Parameters:

entityName - the entity name for the instance to be removed.

object - the instance to be removed

lock

public void lock(Object object,
 LockMode lockMode)

Description copied from interface: Session

Obtain the specified lock level on the given managed instance associated with this session. This operation may be used to:

• perform a version check on an entity read from the second-level cache by requesting LockMode.READ,
• schedule a version check at transaction commit by requesting LockMode.OPTIMISTIC,
• schedule a version increment at transaction commit by requesting LockMode.OPTIMISTIC_FORCE_INCREMENT
• upgrade to a pessimistic lock with LockMode.PESSIMISTIC_READ or LockMode.PESSIMISTIC_WRITE, or
• immediately increment the version of the given instance by requesting LockMode.PESSIMISTIC_FORCE_INCREMENT.

If the requested lock mode is already held on the given entity, this operation has no effect.

This operation cascades to associated instances if the association is mapped with CascadeType.LOCK.

The modes LockMode.WRITE and LockMode.UPGRADE_SKIPLOCKED are not legal arguments to lock().

Specified by:

lock in interface Session

Parameters:

object - a persistent instance

lockMode - the lock level

lock

public void lock(String entityName,
 Object object,
 LockMode lockMode)

Description copied from interface: Session

Obtain the specified lock level on the given managed instance associated with this session. This may be used to:

• perform a version check with LockMode.READ, or
• upgrade to a pessimistic lock with LockMode.PESSIMISTIC_WRITE).

This operation cascades to associated instances if the association is mapped with CascadeType.LOCK.

Specified by:

lock in interface Session

Parameters:

entityName - the name of the entity

object - a persistent instance associated with this session

lockMode - the lock level

lock

public void lock(String entityName,
 Object object,
 LockOptions lockOptions)

Description copied from interface: SessionImplementor

Cascade the lock operation to the given child entity.

Specified by:

lock in interface SessionImplementor

lock

public void lock(Object object,
 LockOptions lockOptions)

Description copied from interface: Session

Obtain a lock on the given managed instance associated with this session, using the given lock options.

This operation cascades to associated instances if the association is mapped with CascadeType.LOCK.

Specified by:

lock in interface Session

Parameters:

object - a persistent instance

lockOptions - the lock options

buildLockRequest

@Deprecated
public Session.LockRequest buildLockRequest(LockOptions lockOptions)

Deprecated.

Description copied from interface: Session

Build a new lock request that specifies:

• the LockMode to use,
• the pessimistic lock timeout, and
• the scope that is, whether the lock extends to rows of owned collections.

Timeout and scope are ignored if the specified LockMode represents a flavor of optimistic locking.

Call Session.LockRequest.lock(Object) to actually obtain the requested lock on a managed entity instance.

Specified by:

buildLockRequest in interface Session

Parameters:

lockOptions - contains the lock level

Returns:

a Session.LockRequest that can be used to lock any given object.

refresh

public void refresh(Object object)

Description copied from interface: Session

Reread the state of the given managed instance associated with this session from the underlying database. This may be useful:

• when a database trigger alters the object state upon insert or update,
• after executing any HQL update or delete statement,
• after executing a native SQL statement, or
• after inserting a Blob or Clob.

This operation cascades to associated instances if the association is mapped with CascadeType.REFRESH.

This operation requests LockMode.READ. To obtain a stronger lock, call Session.refresh(Object, LockMode).

Specified by:

refresh in interface EntityManager

Specified by:

refresh in interface Session

Parameters:

object - a persistent instance associated with this session

refresh

public void refresh(Object entity,
 Map<String,Object> properties)

Description copied from interface: EntityManager

Refresh the state of the instance from the database, using the specified properties, and overwriting changes made to the entity, if any.

If a vendor-specific property or hint is not recognized, it is silently ignored.

Specified by:

refresh in interface EntityManager

Parameters:

entity - entity instance

properties - standard and vendor-specific properties and hints

refresh

public void refresh(Object entity,
 LockModeType lockMode)

Description copied from interface: EntityManager

Refresh the state of the instance from the database, overwriting changes made to the entity, if any, and lock it with respect to given lock mode type.

If the lock mode type is pessimistic and the entity instance is found but cannot be locked:

• the PessimisticLockException will be thrown if the database locking failure causes transaction-level rollback
• the LockTimeoutException will be thrown if the database locking failure causes only statement-level rollback.

Specified by:

refresh in interface EntityManager

Parameters:

entity - entity instance

lockMode - lock mode

refresh

public void refresh(Object entity,
 LockModeType lockMode,
 Map<String,Object> properties)

Description copied from interface: EntityManager

Refresh the state of the instance from the database, overwriting changes made to the entity, if any, and lock it with respect to given lock mode type and with specified properties.

If the lock mode type is pessimistic and the entity instance is found but cannot be locked:

• the PessimisticLockException will be thrown if the database locking failure causes transaction-level rollback
• the LockTimeoutException will be thrown if the database locking failure causes only statement-level rollback

If a vendor-specific property or hint is not recognized, it is silently ignored.

Portable applications should not rely on the standard timeout hint. Depending on the database in use and the locking mechanisms used by the provider, the hint may or may not be observed.

Specified by:

refresh in interface EntityManager

Parameters:

entity - entity instance

lockMode - lock mode

properties - standard and vendor-specific properties and hints

refresh

public void refresh(String entityName,
 Object object)

Description copied from interface: Session

Reread the state of the given managed instance associated with this session from the underlying database. This may be useful:

• when a database trigger alters the object state upon insert or update,
• after executing any HQL update or delete statement,
• after executing a native SQL statement, or
• after inserting a Blob or Clob.

This operation cascades to associated instances if the association is mapped with CascadeType.REFRESH.

Specified by:

refresh in interface Session

Parameters:

entityName - the name of the entity

object - a persistent instance associated with this session

refresh

public void refresh(Object object,
 LockMode lockMode)

Description copied from interface: Session

Reread the state of the given managed instance from the underlying database, obtaining the given LockMode.

Convenient form of Session.refresh(Object, LockOptions)

Specified by:

refresh in interface Session

Parameters:

object - a persistent instance associated with this session

lockMode - the lock mode to use

See Also:

• Session.refresh(Object, LockOptions)

refresh

public void refresh(Object object,
 LockOptions lockOptions)

Description copied from interface: Session

Reread the state of the given managed instance from the underlying database, obtaining the given LockMode.

Specified by:

refresh in interface Session

Parameters:

object - a persistent instance associated with this session

lockOptions - contains the lock mode to use

refresh

public void refresh(String entityName,
 Object object,
 LockOptions lockOptions)

Description copied from interface: Session

Reread the state of the given managed instance from the underlying database, obtaining the given LockMode.

Specified by:

refresh in interface Session

Parameters:

entityName - the name of the entity

object - a persistent instance associated with this session

lockOptions - contains the lock mode to use

getCurrentLockMode

public LockMode getCurrentLockMode(Object object)

Description copied from interface: Session

Determine the current LockMode of the given managed instance associated with this session.

Specified by:

getCurrentLockMode in interface Session

Parameters:

object - a persistent instance associated with this session

Returns:

the current lock mode

clear

public void clear()

Description copied from interface: Session

Completely clear the session. Evict all loaded instances and cancel all pending saves, updates and deletions. Do not close open iterators or instances of ScrollableResults.

Specified by:

clear in interface EntityManager

Specified by:

clear in interface Session

detach

public void detach(Object entity)

Description copied from interface: Session

Remove this instance from the session cache. Changes to the instance will not be synchronized with the database. This operation cascades to associated instances if the association is mapped with CascadeType.DETACH.

Specified by:

detach in interface EntityManager

Specified by:

detach in interface Session

Parameters:

entity - the managed instance to detach

get

public <T> T get(Class<T> theClass,
 Object id)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance. If the instance is already associated with the session, return that instance. This method never returns an uninitialized instance.

This operation is very similar to EntityManager.find(Class, Object).

The object returned by get() or find() is either an unproxied instance of the given entity class, of a fully-fetched proxy object.

This operation requests LockMode.NONE, that is, no lock, allowing the object to be retrieved from the cache without the cost of database access. However, if it is necessary to read the state from the database, the object will be returned with the lock mode LockMode.READ.

To bypass the second-level cache, and ensure that the state is read from the database, either:

• call Session.get(Class, Object, LockMode) with the explicit lock mode LockMode.READ, or
• set the cache mode to CacheMode.IGNORE before calling this method.

Specified by:

get in interface Session

Parameters:

theClass - the entity type

id - an identifier

Returns:

a persistent instance or null

get

public <T> T get(Class<T> theClass,
 Object id,
 LockMode lockMode)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance. If the instance is already associated with the session, return that instance. This method never returns an uninitialized instance. Obtain the specified lock mode if the instance exists.

Convenient form of Session.get(Class, Object, LockOptions).

This operation is very similar to EntityManager.find(Class, Object, jakarta.persistence.LockModeType).

Specified by:

get in interface Session

Parameters:

theClass - the entity type

id - an identifier

lockMode - the lock mode

Returns:

a persistent instance or null

See Also:

• Session.get(Class, Object, LockOptions)

get

public <T> T get(Class<T> theClass,
 Object id,
 LockOptions lockOptions)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance. If the instance is already associated with the session, return that instance. This method never returns an uninitialized instance. Obtain the specified lock mode if the instance exists.

Specified by:

get in interface Session

Parameters:

theClass - the entity type

id - an identifier

lockOptions - the lock mode

Returns:

a persistent instance or null

get

public Object get(String entityName,
 Object id)

Description copied from interface: Session

Return the persistent instance of the given named entity with the given identifier, or null if there is no such persistent instance. If the instance is already associated with the session, return that instance. This method never returns an uninitialized instance.

Specified by:

get in interface Session

Parameters:

entityName - the entity name

id - an identifier

Returns:

a persistent instance or null

get

public Object get(String entityName,
 Object id,
 LockMode lockMode)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance. If the instance is already associated with the session, return that instance. This method never returns an uninitialized instance. Obtain the specified lock mode if the instance exists.

Convenient form of Session.get(String, Object, LockOptions)

Specified by:

get in interface Session

Parameters:

entityName - the entity name

id - an identifier

lockMode - the lock mode

Returns:

a persistent instance or null

See Also:

• Session.get(String, Object, LockOptions)

get

public Object get(String entityName,
 Object id,
 LockOptions lockOptions)

Description copied from interface: Session

Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance. If the instance is already associated with the session, return that instance. This method never returns an uninitialized instance. Obtain the specified lock mode if the instance exists.

Specified by:

get in interface Session

Parameters:

entityName - the entity name

id - an identifier

lockOptions - contains the lock mode

Returns:

a persistent instance or null

getEntityName

public String getEntityName(Object object)

Description copied from interface: Session

Return the entity name for a persistent entity.

Specified by:

getEntityName in interface Session

Parameters:

object - a persistent entity associated with this session

Returns:

the entity name

getReference

public <T> T getReference(T object)

Description copied from interface: Session

Return a reference to the persistent instance with the same identity as the given instance, which might be detached, making the assumption that the instance is still persistent in the database. This method never results in access to the underlying data store, and thus might return a proxy that is initialized on-demand, when a non-identifier method is accessed.

Specified by:

getReference in interface Session

Parameters:

object - a detached persistent instance

Returns:

the persistent instance or proxy

byId

public <T> IdentifierLoadAccess<T> byId(String entityName)

Description copied from interface: Session

Create an IdentifierLoadAccess instance to retrieve an instance of the named entity type by its primary key.

Specified by:

byId in interface Session

Parameters:

entityName - the entity name of the entity type to be retrieved

Returns:

an instance of IdentifierLoadAccess for executing the lookup

byMultipleIds

public <T> MultiIdentifierLoadAccess<T> byMultipleIds(Class<T> entityClass)

Description copied from interface: Session

Create a MultiIdentifierLoadAccess instance to retrieve multiple instances of the given entity type by their primary key values, using batching.

Specified by:

byMultipleIds in interface Session

Parameters:

entityClass - the entity type to be retrieved

Returns:

an instance of MultiIdentifierLoadAccess for executing the lookup

byMultipleIds

public <T> MultiIdentifierLoadAccess<T> byMultipleIds(String entityName)

Description copied from interface: Session

Create a MultiIdentifierLoadAccess instance to retrieve multiple instances of the named entity type by their primary key values, using batching.

Specified by:

byMultipleIds in interface Session

Parameters:

entityName - the entity name of the entity type to be retrieved

Returns:

an instance of MultiIdentifierLoadAccess for executing the lookup

byId

public <T> IdentifierLoadAccess<T> byId(Class<T> entityClass)

Description copied from interface: Session

Create an IdentifierLoadAccess instance to retrieve an instance of the given entity type by its primary key.

Specified by:

byId in interface Session

Parameters:

entityClass - the entity type to be retrieved

Returns:

an instance of IdentifierLoadAccess for executing the lookup

byNaturalId

public <T> NaturalIdLoadAccess<T> byNaturalId(String entityName)

Description copied from interface: Session

Create a NaturalIdLoadAccess instance to retrieve an instance of the named entity type by its natural id, which may be a composite natural id. The entity must have at least one attribute annotated NaturalId.

Specified by:

byNaturalId in interface Session

Parameters:

entityName - the entity name of the entity type to be retrieved

Returns:

an instance of NaturalIdLoadAccess for executing the lookup

byNaturalId

public <T> NaturalIdLoadAccess<T> byNaturalId(Class<T> entityClass)

Description copied from interface: Session

Create a NaturalIdLoadAccess instance to retrieve an instance of the given entity type by its natural id, which may be a composite natural id. The entity must have at least one attribute annotated NaturalId.

Specified by:

byNaturalId in interface Session

Parameters:

entityClass - the entity type to be retrieved

Returns:

an instance of NaturalIdLoadAccess for executing the lookup

bySimpleNaturalId

public <T> SimpleNaturalIdLoadAccess<T> bySimpleNaturalId(String entityName)

Description copied from interface: Session

Create a SimpleNaturalIdLoadAccess instance to retrieve an instance of the named entity type by its natural id, which must be a simple (non-composite) value. The entity must have exactly one attribute annotated NaturalId.

Specified by:

bySimpleNaturalId in interface Session

Parameters:

entityName - the entity name of the entity type to be retrieved

Returns:

an instance of SimpleNaturalIdLoadAccess for executing the lookup

bySimpleNaturalId

public <T> SimpleNaturalIdLoadAccess<T> bySimpleNaturalId(Class<T> entityClass)

Description copied from interface: Session

Create a SimpleNaturalIdLoadAccess instance to retrieve an instance of the given entity type by its natural id, which must be a simple (non-composite) value. The entity must have exactly one attribute annotated NaturalId.

Specified by:

bySimpleNaturalId in interface Session

Parameters:

entityClass - the entity type to be retrieved

Returns:

an instance of SimpleNaturalIdLoadAccess for executing the lookup

byMultipleNaturalId

public <T> NaturalIdMultiLoadAccess<T> byMultipleNaturalId(Class<T> entityClass)

Description copied from interface: Session

Create a MultiIdentifierLoadAccess instance to retrieve multiple instances of the given entity type by their by natural id values, using batching.

Specified by:

byMultipleNaturalId in interface Session

Parameters:

entityClass - the entity type to be retrieved

Returns:

an instance of NaturalIdMultiLoadAccess for executing the lookup

byMultipleNaturalId

public <T> NaturalIdMultiLoadAccess<T> byMultipleNaturalId(String entityName)

Description copied from interface: Session

Create a MultiIdentifierLoadAccess instance to retrieve multiple instances of the named entity type by their by natural id values, using batching.

Specified by:

byMultipleNaturalId in interface Session

Parameters:

entityName - the entity name of the entity type to be retrieved

Returns:

an instance of NaturalIdMultiLoadAccess for executing the lookup

enableFilter

public Filter enableFilter(String filterName)

Description copied from interface: SharedSessionContract

Enable the named filter for this current session.

The returned Filter object must be used to bind arguments to parameters of the filter, and every parameter must be set before any other operation of this session is called.

Specified by:

enableFilter in interface Session

Specified by:

enableFilter in interface SharedSessionContract

Parameters:

filterName - the name of the filter to be enabled.

Returns:

the Filter instance representing the enabled filter.

See Also:

• FilterDef

getEnabledFilter

public Filter getEnabledFilter(String filterName)

Description copied from interface: SharedSessionContract

Retrieve a currently enabled filter by name.

Specified by:

getEnabledFilter in interface Session

Specified by:

getEnabledFilter in interface SharedSessionContract

Parameters:

filterName - the name of the filter to be retrieved.

Returns:

the Filter instance representing the enabled filter.

disableFilter

public void disableFilter(String filterName)

Description copied from interface: SharedSessionContract

Disable the named filter for the current session.

Specified by:

disableFilter in interface Session

Specified by:

disableFilter in interface SharedSessionContract

Parameters:

filterName - the name of the filter to be disabled.

getStatistics

public SessionStatistics getStatistics()

Description copied from interface: Session

Get the statistics for this session.

Specified by:

getStatistics in interface Session

Returns:

the session statistics being collected for this session

isReadOnly

public boolean isReadOnly(Object entityOrProxy)

Description copied from interface: Session

Is the specified entity or proxy read-only?

To get the default read-only/modifiable setting used for entities and proxies that are loaded into the session use Session.isDefaultReadOnly()

Specified by:

isReadOnly in interface Session

Parameters:

entityOrProxy - an entity or proxy

Returns:

true if the entity or proxy is read-only, false if the entity or proxy is modifiable.

See Also:

• Session.isDefaultReadOnly()

setReadOnly

public void setReadOnly(Object entityOrProxy,
 boolean readOnly)

Description copied from interface: Session

Set an unmodified persistent object to read-only mode, or a read-only object to modifiable mode. In read-only mode, no snapshot is maintained, the instance is never dirty checked, and changes are not persisted.

If the entity or proxy already has the specified read-only/modifiable setting, then this method does nothing.

To set the default read-only/modifiable setting used for all entities and proxies that are loaded into the session use Session.setDefaultReadOnly(boolean).

To override this session's read-only/modifiable setting for entities and proxies loaded by a Query use Query.setReadOnly(boolean)

Specified by:

setReadOnly in interface Session

Parameters:

entityOrProxy - an entity or proxy

readOnly - true if the entity or proxy should be made read-only; false if the entity or proxy should be made modifiable

See Also:

• Session.setDefaultReadOnly(boolean)
• Query.setReadOnly(boolean)
• IdentifierLoadAccess.withReadOnly(boolean)

doWork

public void doWork(Work work)
            throws HibernateException

Description copied from interface: SharedSessionContract

Perform work using the Connection underlying by this session.

Specified by:

doWork in interface SharedSessionContract

Parameters:

work - The work to be performed.

Throws:

HibernateException - Generally indicates wrapped SQLException

doReturningWork

public <T> T doReturningWork(ReturningWork<T> work)
                      throws HibernateException

Description copied from interface: SharedSessionContract

Perform work using the Connection underlying by this session, and return a result.

Specified by:

doReturningWork in interface SharedSessionContract

Type Parameters:

T - The type of the result returned from the work

Parameters:

work - The work to be performed.

Returns:

the result of calling ReturningWork.execute(java.sql.Connection).

Throws:

HibernateException - Generally indicates wrapped SQLException

isFetchProfileEnabled

public boolean isFetchProfileEnabled(String name)
                              throws UnknownProfileException

Description copied from interface: Session

Is the fetch profile with the given name enabled in this session?

Specified by:

isFetchProfileEnabled in interface Session

Parameters:

name - the name of the profile

Returns:

True if fetch profile is enabled; false if not.

Throws:

UnknownProfileException - Indicates that the given name does not match any known fetch profile names

See Also:

• FetchProfile

enableFetchProfile

public void enableFetchProfile(String name)
                        throws UnknownProfileException

Description copied from interface: Session

Enable the fetch profile with the given name in this session. If the requested fetch profile is already enabled, the call has no effect.

Specified by:

enableFetchProfile in interface Session

Parameters:

name - the name of the fetch profile to be enabled

Throws:

UnknownProfileException - Indicates that the given name does not match any known fetch profile names

See Also:

• FetchProfile

disableFetchProfile

public void disableFetchProfile(String name)
                         throws UnknownProfileException

Description copied from interface: Session

Disable the fetch profile with the given name in this session. If the requested fetch profile is not currently enabled, the call has no effect.

Specified by:

disableFetchProfile in interface Session

Parameters:

name - the name of the fetch profile to be disabled

Throws:

UnknownProfileException - Indicates that the given name does not match any known fetch profile names

See Also:

• FetchProfile

getLobHelper

public LobHelper getLobHelper()

Description copied from interface: Session

Obtain a factory for instances of Blob and Clob.

Specified by:

getLobHelper in interface Session

Returns:

an instance of LobHelper

addEventListeners

public void addEventListeners(SessionEventListener... listeners)

Description copied from interface: Session

Add one or more listeners to the Session

Specified by:

addEventListeners in interface Session

Parameters:

listeners - the listener(s) to add

getActionQueue

public ActionQueue getActionQueue()

Description copied from interface: SessionImplementor

Get the ActionQueue associated with this session.

Specified by:

getActionQueue in interface SessionImplementor

instantiate

public Object instantiate(EntityPersister persister,
 Object id)
                   throws HibernateException

Description copied from interface: SharedSessionContractImplementor

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

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

Specified by:

instantiate in interface SessionImplementor

Specified by:

instantiate in interface SharedSessionContractImplementor

Throws:

HibernateException

forceFlush

public void forceFlush(EntityEntry e)
                throws HibernateException

Description copied from interface: SessionImplementor

Initiate a flush to force deletion of a re-persisted entity.

Specified by:

forceFlush in interface SessionImplementor

Throws:

HibernateException

forceFlush

public void forceFlush(EntityKey e)
                throws HibernateException

Description copied from interface: SessionImplementor

Initiate a flush to force deletion of a re-persisted entity.

Specified by:

forceFlush in interface SessionImplementor

Throws:

HibernateException

merge

public void merge(String entityName,
 Object object,
 MergeContext copiedAlready)
           throws HibernateException

Specified by:

merge in interface SessionImplementor

Throws:

HibernateException

persist

public void persist(String entityName,
 Object object,
 PersistContext createdAlready)
             throws HibernateException

Specified by:

persist in interface SessionImplementor

Throws:

HibernateException

persistOnFlush

public void persistOnFlush(String entityName,
 Object object,
 PersistContext copiedAlready)

Specified by:

persistOnFlush in interface SessionImplementor

refresh

public void refresh(String entityName,
 Object object,
 RefreshContext refreshedAlready)
             throws HibernateException

Specified by:

refresh in interface SessionImplementor

Throws:

HibernateException

delete

public void delete(String entityName,
 Object child,
 boolean isCascadeDeleteEnabled,
 DeleteContext transientEntities)

Specified by:

delete in interface SessionImplementor

removeOrphanBeforeUpdates

public void removeOrphanBeforeUpdates(String entityName,
 Object child)

Specified by:

removeOrphanBeforeUpdates in interface SessionImplementor

getSession

public SessionImplementor getSession()

Description copied from interface: SharedSessionContractImplementor

Returns this object, fulfilling the contract of WrapperOptions.

Specified by:

getSession in interface SessionImplementor

Specified by:

getSession in interface SharedSessionContractImplementor

Specified by:

getSession in interface WrapperOptions

useStreamForLobBinding

public boolean useStreamForLobBinding()

Description copied from interface: WrapperOptions

Determines whether streams should be used for binding LOB values.

Specified by:

useStreamForLobBinding in interface WrapperOptions

Returns:

true/false

See Also:

• Dialect.useInputStreamToInsertBlob()

getPreferredSqlTypeCodeForBoolean

public int getPreferredSqlTypeCodeForBoolean()

Description copied from interface: WrapperOptions

The JDBC type code used to bind a null boolean value.

Specified by:

getPreferredSqlTypeCodeForBoolean in interface WrapperOptions

See Also:

• MappingSettings.PREFERRED_BOOLEAN_JDBC_TYPE
• Dialect.getPreferredSqlTypeCodeForBoolean()

getLobCreator

public LobCreator getLobCreator()

Description copied from interface: WrapperOptions

Obtain access to the LobCreator.

Specified by:

getLobCreator in interface WrapperOptions

Returns:

The LOB creator

See Also:

• JdbcSettings.NON_CONTEXTUAL_LOB_CREATION
• Dialect.getDefaultNonContextualLobCreation()

getJdbcBatchSize

public Integer getJdbcBatchSize()

Description copied from interface: SharedSessionContract

Get the session-level JDBC batch size for the current session.

Specified by:

getJdbcBatchSize in interface JdbcSessionOwner

Specified by:

getJdbcBatchSize in interface SharedSessionContract

Returns:

the current session-level JDBC batch size

See Also:

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

getEventManager

public EventManager getEventManager()

Specified by:

getEventManager in interface JdbcSessionOwner

setJdbcBatchSize

public void setJdbcBatchSize(Integer jdbcBatchSize)

Description copied from interface: SharedSessionContract

Set the session-level JDBC batch size. Override the factory-level JDBC batch size controlled by the configuration property "hibernate.jdbc.batch_size".

Specified by:

setJdbcBatchSize in interface SharedSessionContract

Parameters:

jdbcBatchSize - the new session-level JDBC batch size

See Also:

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

isSubselectFetchingEnabled

public boolean isSubselectFetchingEnabled()

Description copied from interface: Session

Determine if subselect fetching is enabled in this session.

Specified by:

isSubselectFetchingEnabled in interface Session

Returns:

true is subselect fetching is enabled

setSubselectFetchingEnabled

public void setSubselectFetchingEnabled(boolean enabled)

Description copied from interface: Session

Enable or disable subselect fetching in this session. Override the factory-level default controlled by the configuration property "hibernate.use_subselect_fetch".

Specified by:

setSubselectFetchingEnabled in interface Session

Parameters:

enabled - true to enable subselect fetching

See Also:

• FetchSettings.USE_SUBSELECT_FETCH

getFetchBatchSize

public int getFetchBatchSize()

Description copied from interface: Session

Get the maximum batch size for batch fetching associations by id in this session.

Specified by:

getFetchBatchSize in interface Session

setFetchBatchSize

public void setFetchBatchSize(int batchSize)

Description copied from interface: Session

Set the maximum batch size for batch fetching associations by id in this session. Override the factory-level default controlled by the configuration property "hibernate.default_batch_fetch_size".

• If batchSize>1, then batch fetching is enabled.
• If batchSize<0, the batch size is inherited from the factory-level setting.
• Otherwise, batch fetching is disabled.

Specified by:

setFetchBatchSize in interface Session

Parameters:

batchSize - the maximum batch size for batch fetching

See Also:

• FetchSettings.DEFAULT_BATCH_FETCH_SIZE

getJdbcTimeZone

public TimeZone getJdbcTimeZone()

Description copied from interface: WrapperOptions

The JDBC TimeZone used when writing a value of type Time or Timestamp to a JDBC PreparedStatement, or when reading from a JDBC ResultSet.

• When getJdbcTimeZone() is null, the method PreparedStatement.setTimestamp(int, java.sql.Timestamp) is called to write a timestamp, and ResultSet.getTimestamp(int) is called to read a timestamp.
• But when not null, the method PreparedStatement.setTimestamp(int, java.sql.Timestamp, java.util.Calendar) is called to write a timestamp, and ResultSet.getTimestamp(int, java.util.Calendar) is called to read a timestamp.

Thus, the storage TimeZone can differ from the default JVM TimeZone given by TimeZone.getDefault().

Specified by:

getJdbcTimeZone in interface WrapperOptions

Returns:

the JDBC TimeZone, or null if no JDBC timezone was explicitly set

See Also:

• JdbcSettings.JDBC_TIME_ZONE