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 ofSessionImplementor
. This is useful for custom implementations of that API, so that only some methods need to be overridden(Used by Hibernate Search).
- 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 SessionImplementor
delegate
-
Constructor Summary
Constructors Constructor Description SessionDelegatorBaseImpl(SessionImplementor delegate)
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description Transaction
accessTransaction()
Retrieves the currentTransaction
, or creates a new transaction if there is no transaction active.void
addEventListeners(SessionEventListener... listeners)
Add one or more listeners to the Sessionvoid
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 aScrollableResults
, 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 toEventSource
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 flushvoid
beforeTransactionCompletion()
A before-completion callback to the owner.Transaction
beginTransaction()
Begin a unit of work and return the associatedTransaction
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 anIdentifierLoadAccess
instance to retrieve the specified entity by primary key.<T> IdentifierLoadAccess<T>
byId(String entityName)
Create anIdentifierLoadAccess
instance to retrieve the specified entity type by primary key.<T> MultiIdentifierLoadAccess<T>
byMultipleIds(Class<T> entityClass)
Create aMultiIdentifierLoadAccess
instance to retrieve multiple entities at once as specified by primary key values.<T> MultiIdentifierLoadAccess<T>
byMultipleIds(String entityName)
Create aMultiIdentifierLoadAccess
instance to retrieve multiple entities at once as specified by primary key values.<T> NaturalIdMultiLoadAccess<T>
byMultipleNaturalId(Class<T> entityClass)
Access to load multiple entities bynatural id
.<T> NaturalIdMultiLoadAccess<T>
byMultipleNaturalId(String entityName)
Access to load multiple entities bynatural id
.<T> NaturalIdLoadAccess<T>
byNaturalId(Class<T> entityClass)
Create aNaturalIdLoadAccess
instance to retrieve the specified entity by its natural id.<T> NaturalIdLoadAccess<T>
byNaturalId(String entityName)
Create aNaturalIdLoadAccess
instance to retrieve the specified entity by its natural id.<T> SimpleNaturalIdLoadAccess<T>
bySimpleNaturalId(Class<T> entityClass)
Create aSimpleNaturalIdLoadAccess
instance to retrieve the specified entity by its simple (single attribute)natural id
.<T> SimpleNaturalIdLoadAccess<T>
bySimpleNaturalId(String entityName)
Create aSimpleNaturalIdLoadAccess
instance to retrieve the specified entity by itsnatural id
.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 anIllegalStateException
.void
checkOpen(boolean markForRollbackIfClosed)
Check whether the session is open, and if not: ifmarkForRollbackIfClosed = true
, mark the current transaction, if any, for rollback only, and throw anIllegalStateException
.void
checkTransactionNeededForUpdateOperation(String exceptionMessage)
Check if an activeTransaction
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)
boolean
contains(String entityName, Object object)
Determine if the given entity is associated with this session.<T> RootGraphImplementor<T>
createEntityGraph(Class<T> rootType)
RootGraphImplementor<?>
createEntityGraph(String graphName)
MutationQuery
createMutationQuery(CriteriaDelete deleteQuery)
Create aMutationQuery
from the given delete criteria treeMutationQuery
createMutationQuery(CriteriaUpdate updateQuery)
Create aMutationQuery
from the given update criteria treeMutationQuery
createMutationQuery(String statementString)
Create a MutationQuery reference for the given HQL insert, update, or delete statement.MutationQuery
createMutationQuery(JpaCriteriaInsertSelect insertSelect)
Create aMutationQuery
from the given insert-select criteria treeMutationQuery
createNamedMutationQuery(String name)
Create aMutationQuery
instance for the given named insert, update, or delete HQL query.QueryImplementor
createNamedQuery(String name)
Create a typedQuery
instance for the given named query.<T> QueryImplementor<T>
createNamedQuery(String name, Class<T> resultClass)
Create a typedQuery
instance for the given named query.SelectionQuery<?>
createNamedSelectionQuery(String name)
Create aSelectionQuery
instance for the namedNamedQuery
<R> SelectionQuery<R>
createNamedSelectionQuery(String name, Class<R> resultType)
Create aSelectionQuery
instance for the namedNamedQuery
with the expected result-typeProcedureCall
createNamedStoredProcedureQuery(String name)
Obtain aProcedureCall
based on a named templateMutationQuery
createNativeMutationQuery(String sqlString)
Create aNativeQuery
instance for the given native SQL statement.NativeQueryImplementor
createNativeQuery(String sqlString)
Create aNativeQuery
instance for the given native SQL query.NativeQueryImplementor
createNativeQuery(String sqlString, Class resultClass)
Create aNativeQuery
instance for the given native SQL query using implicit mapping to the specified Java type.<T> NativeQueryImplementor<T>
createNativeQuery(String sqlString, Class<T> resultClass, String tableAlias)
Create aNativeQuery
instance for the given native SQL query using implicit mapping to the specified Java type.NativeQueryImplementor
createNativeQuery(String sqlString, String resultSetMappingName)
Create aNativeQuery
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 aNativeQuery
instance for the given native SQL query using an explicit mapping to the specified Java type.QueryImplementor
createQuery(CriteriaDelete deleteQuery)
Create aQuery
for the given JPACriteriaDelete
.<T> QueryImplementor<T>
createQuery(CriteriaQuery<T> criteriaQuery)
Create aQuery
for the given JPACriteriaQuery
.QueryImplementor
createQuery(CriteriaUpdate updateQuery)
Create aQuery
for the given JPACriteriaUpdate
.QueryImplementor
createQuery(String queryString)
Create aQuery
instance for the given HQL query, or HQL insert, update, or delete statement.<T> QueryImplementor<T>
createQuery(String queryString, Class<T> resultType)
Create a typedQuery
instance for the given HQL query string.<R> SelectionQuery<R>
createSelectionQuery(CriteriaQuery<R> criteria)
Create aSelectionQuery
reference for the given Criteria.SelectionQuery<?>
createSelectionQuery(String hqlString)
Create aSelectionQuery
reference for the given HQL.<R> SelectionQuery<R>
createSelectionQuery(String hqlString, Class<R> resultType)
Create aSelectionQuery
reference for the given HQL.ProcedureCall
createStoredProcedureCall(String procedureName)
Create aProcedureCall
to a stored procedure.ProcedureCall
createStoredProcedureCall(String procedureName, Class<?>... resultClasses)
Create aProcedureCall
to a stored procedure with the given result set entity mappings.ProcedureCall
createStoredProcedureCall(String procedureName, String... resultSetMappings)
Create aProcedureCall
to a stored procedure with the given result set entity mappings.ProcedureCall
createStoredProcedureQuery(String procedureName)
Create aProcedureCall
to a stored procedure.ProcedureCall
createStoredProcedureQuery(String procedureName, Class... resultClasses)
Create aProcedureCall
to a stored procedure with the given result set entity mappings.ProcedureCall
createStoredProcedureQuery(String procedureName, String... resultSetMappings)
Create aProcedureCall
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 thefetch 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 theConnection
underlying by this session, and return a result.void
doWork(Work work)
Perform work using theConnection
underlying by this session.void
enableFetchProfile(String name)
Enable thefetch 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 JDBCConnection
.<T> T
find(Class<T> entityClass, Object primaryKey)
<T> T
find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)
<T> T
find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String,Object> properties)
<T> T
find(Class<T> entityClass, Object primaryKey, Map<String,Object> 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 anEntityKey
with the given id and for the entity represented by the givenEntityPersister
.<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 theActionQueue
associated with this session.CacheMode
getCacheMode()
Get the currentcache mode
for this session.CacheRetrieveMode
getCacheRetrieveMode()
The JPA-definedCacheRetrieveMode
.CacheStoreMode
getCacheStoreMode()
The JPA-definedCacheStoreMode
.CacheTransactionSynchronization
getCacheTransactionSynchronization()
The currentCacheTransactionSynchronization
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()
LockMode
getCurrentLockMode(Object object)
Determine the currentLockMode
of the given managed instance associated with this session.Object
getDelegate()
This is the implementation ofEntityManager.getDelegate()
.Filter
getEnabledFilter(String filterName)
Retrieve a currently enabled filter by name.RootGraphImplementor<?>
getEntityGraph(String graphName)
<T> List<EntityGraph<? super T>>
getEntityGraphs(Class<T> entityClass)
EntityManagerFactory
getEntityManagerFactory()
String
getEntityName(Object object)
Return the entity name for a persistent entity.EntityPersister
getEntityPersister(String entityName, Object object)
Get theEntityPersister
for the given entity instance.Object
getEntityUsingInterceptor(EntityKey key)
Get the entity instance associated with the givenEntityKey
, calling theInterceptor
if necessary.SessionEventListenerManager
getEventListenerManager()
Get theSessionEventListenerManager
associated with this session.ExceptionConverter
getExceptionConverter()
Obtain anExceptionConverter
for reporting an error.SessionFactoryImplementor
getFactory()
Obtain the factory which created this session.FlushModeType
getFlushMode()
Get the currentJPA flush mode
for this session.FlushMode
getHibernateFlushMode()
Get the currentflush mode
for this session.Object
getIdentifier(Object object)
Return the identifier value of the given entity associated with this session.Interceptor
getInterceptor()
Retrieves theInterceptor
associated with this session.Integer
getJdbcBatchSize()
Get the session-level JDBC batch size for the current session.JdbcConnectionAccess
getJdbcConnectionAccess()
JdbcCoordinator
getJdbcCoordinator()
Obtain theJdbcCoordinator
for this session.JdbcServices
getJdbcServices()
Obtain theJdbcServices
for the factory which created this session.JdbcSessionContext
getJdbcSessionContext()
TimeZone
getJdbcTimeZone()
The JDBCTimeZone
used when writing a value of typeTime
orTimestamp
to a JDBCPreparedStatement
, or when reading from a JDBCResultSet
.LoadQueryInfluencers
getLoadQueryInfluencers()
Get theLoadQueryInfluencers
associated with this session.LobCreator
getLobCreator()
Obtain access to theLobCreator
.LobHelper
getLobHelper()
LockModeType
getLockMode(Object entity)
Metamodel
getMetamodel()
NativeQueryImplementor
getNamedNativeQuery(String name)
Get aNativeQuery
instance for a named native SQL queryNativeQueryImplementor
getNamedNativeQuery(String name, String resultSetMapping)
Get aNativeQuery
instance for a named native SQL queryProcedureCall
getNamedProcedureCall(String name)
Obtain aProcedureCall
based on a named templateQueryImplementor
getNamedQuery(String name)
Create aQuery
instance for the named query.PersistenceContext
getPersistenceContext()
Get the persistence context for this session.PersistenceContext
getPersistenceContextInternal()
Similar toSharedSessionContractImplementor.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 JDBCtype code
used to bind a null boolean value.Map<String,Object>
getProperties()
<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 ofWrapperOptions
.SessionFactoryImplementor
getSessionFactory()
Get the session factory which created this session.UUID
getSessionIdentifier()
Obtain aUUID
which uniquely identifies this session.SessionStatistics
getStatistics()
Get the statistics for this session.String
getTenantIdentifier()
Obtain the tenant identifier associated with this session.Transaction
getTransaction()
Get theTransaction
instance associated with this session.TransactionCoordinator
getTransactionCoordinator()
Obtain the builder for TransactionCoordinator instanceslong
getTransactionStartTimestamp()
Deprecated, for removal: This API element is subject to removal in a future version.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 theEntityNameResolver
.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 givenEntityPersister
, 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? In other words, would any DML operations be executed if we flushed this session?boolean
isEventSource()
Determines if this session implementsEventSource
.boolean
isFetchProfileEnabled(String name)
Is thefetch 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
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)
void
lock(Object entity, LockModeType lockMode, Map<String,Object> 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 givenlock 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 aQuery
orProcedureCall
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)
void
refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)
void
refresh(Object entity, Map<String,Object> properties)
void
refresh(Object object, LockMode lockMode)
Reread the state of the given managed instance from the underlying database, obtaining the givenLockMode
.void
refresh(Object object, LockOptions lockOptions)
Reread the state of the given managed instance from the underlying database, obtaining the givenLockMode
.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 givenLockMode
.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)
EitherSession.save(Object)
orSession.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)
EitherSession.save(String, Object)
orSession.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 aSession
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 currentcache 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
setFlushMode(FlushModeType flushModeType)
Set the currentJPA flush mode
for this session.void
setHibernateFlushMode(FlushMode flushMode)
Set the currentflush mode
for this session.void
setJdbcBatchSize(Integer jdbcBatchSize)
Set the session-level JDBC batch size.void
setProperty(String propertyName, Object value)
void
setReadOnly(Object entityOrProxy, boolean readOnly)
Set an unmodified persistent object to read-only mode, or a read-only object to modifiable mode.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 HibernateTransaction
API or via registration of Hibernate's JTA Synchronization impl with a JTA Transaction<T> T
unwrap(Class<T> cls)
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.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
-
-
-
-
Field Detail
-
delegate
protected final SessionImplementor delegate
-
-
Constructor Detail
-
SessionDelegatorBaseImpl
public SessionDelegatorBaseImpl(SessionImplementor delegate)
-
-
Method Detail
-
delegate
protected SessionImplementor delegate()
Returns the delegate session.- See Also:
getDelegate()
- API Note:
- This returns a different object to the
getDelegate()
method inherited fromEntityManager
.
-
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 JDBCConnection
.- Specified by:
execute
in interfaceLobCreationContext
- Type Parameters:
T
- The Java type of the type of LOB being created. One ofBlob
,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 interfaceSharedSessionContract
- Returns:
- The tenant identifier associated with this session, or
null
-
getSessionIdentifier
public UUID getSessionIdentifier()
Description copied from interface:SharedSessionContractImplementor
Obtain aUUID
which uniquely identifies this session.The UUID is useful mainly for logging.
- Specified by:
getSessionIdentifier
in interfaceSharedSessionContractImplementor
-
getJdbcConnectionAccess
public JdbcConnectionAccess getJdbcConnectionAccess()
- Specified by:
getJdbcConnectionAccess
in interfaceJdbcSessionOwner
-
generateEntityKey
public EntityKey generateEntityKey(Object id, EntityPersister persister)
Description copied from interface:SharedSessionContractImplementor
Instantiate anEntityKey
with the given id and for the entity represented by the givenEntityPersister
.- Specified by:
generateEntityKey
in interfaceSharedSessionContractImplementor
- Parameters:
id
- The entity idpersister
- The entity persister- Returns:
- The entity key
-
getInterceptor
public Interceptor getInterceptor()
Description copied from interface:SharedSessionContractImplementor
Retrieves theInterceptor
associated with this session.- Specified by:
getInterceptor
in interfaceSharedSessionContractImplementor
-
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 interfaceSharedSessionContractImplementor
-
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 interfaceSharedSessionContractImplementor
-
checkTransactionNeededForUpdateOperation
public void checkTransactionNeededForUpdateOperation(String exceptionMessage)
Description copied from interface:SharedSessionContractImplementor
Check if an activeTransaction
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 interfaceSharedSessionContractImplementor
- Parameters:
exceptionMessage
- the message to use for theTransactionRequiredException
-
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 interfaceSharedSessionContractImplementor
- 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, anull
value is returned.
When
eager = true
, the object is eagerly fetched from the database.- Specified by:
internalLoad
in interfaceSharedSessionContractImplementor
- Throws:
HibernateException
- When
-
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 interfaceSharedSessionContractImplementor
- Throws:
HibernateException
-
getFactory
public SessionFactoryImplementor getFactory()
Description copied from interface:SharedSessionContractImplementor
Obtain the factory which created this session.- Specified by:
getFactory
in interfaceQueryProducerImplementor
- Specified by:
getFactory
in interfaceSharedSessionContractImplementor
-
getEntityPersister
public EntityPersister getEntityPersister(String entityName, Object object) throws HibernateException
Description copied from interface:SharedSessionContractImplementor
Get theEntityPersister
for the given entity instance.- Specified by:
getEntityPersister
in interfaceSharedSessionContractImplementor
- Parameters:
entityName
- optional entity nameobject
- 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 givenEntityKey
, calling theInterceptor
if necessary.- Specified by:
getEntityUsingInterceptor
in interfaceSharedSessionContractImplementor
- 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 interfaceSharedSessionContractImplementor
-
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 interfaceSharedSessionContractImplementor
-
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 theEntityNameResolver
.- Specified by:
guessEntityName
in interfaceSharedSessionContractImplementor
- 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 interfaceSharedSessionContractImplementor
- 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 interfaceSharedSessionContractImplementor
-
getCacheMode
public CacheMode getCacheMode()
Description copied from interface:Session
Get the currentcache mode
for this session.- Specified by:
getCacheMode
in interfaceQueryProducerImplementor
- Specified by:
getCacheMode
in interfaceSession
- Specified by:
getCacheMode
in interfaceSharedSessionContractImplementor
- Returns:
- the current cache mode
-
getCacheRetrieveMode
public CacheRetrieveMode getCacheRetrieveMode()
Description copied from interface:Session
The JPA-definedCacheRetrieveMode
.- Specified by:
getCacheRetrieveMode
in interfaceSession
- See Also:
Session.getCacheMode()
-
getCacheStoreMode
public CacheStoreMode getCacheStoreMode()
Description copied from interface:Session
The JPA-definedCacheStoreMode
.- Specified by:
getCacheStoreMode
in interfaceSession
- See Also:
Session.getCacheMode()
-
setCacheMode
public void setCacheMode(CacheMode cm)
Description copied from interface:Session
Set the currentcache 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 interfaceSession
- Specified by:
setCacheMode
in interfaceSharedSessionContractImplementor
- 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 interfaceSession
- Parameters:
cacheStoreMode
- a JPA-definedCacheStoreMode
- 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 interfaceSession
- Parameters:
cacheRetrieveMode
- a JPA-definedCacheRetrieveMode
- See Also:
Session.setCacheMode(CacheMode)
-
setCriteriaCopyTreeEnabled
public void setCriteriaCopyTreeEnabled(boolean jpaCriteriaCopyComplianceEnabled)
- Specified by:
setCriteriaCopyTreeEnabled
in interfaceSharedSessionContractImplementor
-
isCriteriaCopyTreeEnabled
public boolean isCriteriaCopyTreeEnabled()
- Specified by:
isCriteriaCopyTreeEnabled
in interfaceSharedSessionContractImplementor
-
isOpen
public boolean isOpen()
Description copied from interface:SharedSessionContract
Check if the session is still open.- Specified by:
isOpen
in interfaceEntityManager
- Specified by:
isOpen
in interfaceSharedSessionContract
- Returns:
- boolean
-
isConnected
public boolean isConnected()
Description copied from interface:SharedSessionContract
Check if the session is currently connected.- Specified by:
isConnected
in interfaceSharedSessionContract
- 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 interfaceSharedSessionContractImplementor
- if
-
markForRollbackOnly
public void markForRollbackOnly()
Description copied from interface:SharedSessionContractImplementor
Marks current transaction, if any, for rollback only.- Specified by:
markForRollbackOnly
in interfaceSharedSessionContractImplementor
-
getTransactionStartTimestamp
@Deprecated(forRemoval=true) public long getTransactionStartTimestamp()
Deprecated, for removal: This API element is subject to removal in a future version.Description copied from interface:SharedSessionContractImplementor
A "timestamp" at or before the start of the current transaction.- Specified by:
getTransactionStartTimestamp
in interfaceSharedSessionContractImplementor
-
getFlushMode
public FlushModeType getFlushMode()
Description copied from interface:Session
Get the currentJPA flush mode
for this session.- Specified by:
getFlushMode
in interfaceEntityManager
- Specified by:
getFlushMode
in interfaceSession
- Specified by:
getFlushMode
in interfaceSharedSessionContractImplementor
- Returns:
- the
FlushModeType
currently in effect
-
setFlushMode
public void setFlushMode(FlushModeType flushModeType)
Description copied from interface:Session
Set the currentJPA 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 interfaceEntityManager
- Specified by:
setFlushMode
in interfaceSession
- Parameters:
flushModeType
- the newFlushModeType
- See Also:
for additional options
-
setHibernateFlushMode
public void setHibernateFlushMode(FlushMode flushMode)
Description copied from interface:Session
Set the currentflush 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 toFlushMode.MANUAL
at the start of the session in order to avoid some unnecessary work.Note that
FlushMode
defines more options thanFlushModeType
.- Specified by:
setHibernateFlushMode
in interfaceSession
- Specified by:
setHibernateFlushMode
in interfaceSharedSessionContractImplementor
- Parameters:
flushMode
- the newFlushMode
-
getHibernateFlushMode
public FlushMode getHibernateFlushMode()
Description copied from interface:Session
Get the currentflush mode
for this session.- Specified by:
getHibernateFlushMode
in interfaceQueryProducerImplementor
- Specified by:
getHibernateFlushMode
in interfaceSession
- Specified by:
getHibernateFlushMode
in interfaceSharedSessionContractImplementor
- Returns:
- the
FlushMode
currently in effect
-
lock
public void lock(Object entity, LockModeType lockMode)
- Specified by:
lock
in interfaceEntityManager
-
lock
public void lock(Object entity, LockModeType lockMode, Map<String,Object> properties)
- Specified by:
lock
in interfaceEntityManager
-
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 whenEntityTransaction.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 interfaceEntityManager
- Specified by:
flush
in interfaceSession
- Specified by:
flush
in interfaceSharedSessionContractImplementor
-
isEventSource
public boolean isEventSource()
Description copied from interface:SharedSessionContractImplementor
Determines if this session implementsEventSource
.Only stateful session are sources of events. If this object is a stateless session, this method return
false
.- Specified by:
isEventSource
in interfaceSharedSessionContractImplementor
-
asEventSource
public EventSource asEventSource()
Description copied from interface:SharedSessionContractImplementor
Cast this session toEventSource
if possible.Only stateful session are sources of events. If this object is a stateless session, this method throws.
- Specified by:
asEventSource
in interfaceSharedSessionContractImplementor
-
afterScrollOperation
public void afterScrollOperation()
Description copied from interface:SharedSessionContractImplementor
Called after each operation on aScrollableResults
, 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 interfaceSharedSessionContractImplementor
-
getTransactionCoordinator
public TransactionCoordinator getTransactionCoordinator()
Description copied from interface:JdbcSessionOwner
Obtain the builder for TransactionCoordinator instances- Specified by:
getTransactionCoordinator
in interfaceJdbcSessionOwner
- Returns:
- The TransactionCoordinatorBuilder
-
getJdbcCoordinator
public JdbcCoordinator getJdbcCoordinator()
Description copied from interface:SharedSessionContractImplementor
Obtain theJdbcCoordinator
for this session.- Specified by:
getJdbcCoordinator
in interfaceSharedSessionContractImplementor
-
getJdbcServices
public JdbcServices getJdbcServices()
Description copied from interface:SharedSessionContractImplementor
Obtain theJdbcServices
for the factory which created this session.- Specified by:
getJdbcServices
in interfaceSharedSessionContractImplementor
-
getJdbcSessionContext
public JdbcSessionContext getJdbcSessionContext()
- Specified by:
getJdbcSessionContext
in interfaceJdbcSessionOwner
-
isClosed
public boolean isClosed()
Description copied from interface:SharedSessionContractImplementor
Determines whether the session is closed.- Specified by:
isClosed
in interfaceSharedSessionContractImplementor
- 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 interfaceSharedSessionContractImplementor
-
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 interfaceSharedSessionContractImplementor
- 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 interfaceSharedSessionContractImplementor
-
isAutoCloseSessionEnabled
public boolean isAutoCloseSessionEnabled()
Description copied from interface:SharedSessionContractImplementor
Is auto-close at transaction completion enabled?- Specified by:
isAutoCloseSessionEnabled
in interfaceSharedSessionContractImplementor
- See Also:
AvailableSettings.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 interfaceTransactionCoordinatorBuilder.Options
- Returns:
true
indicates the active transaction should be auto joined;false
indicates it should not (untilTransactionCoordinator.explicitJoin()
is called).
-
getLoadQueryInfluencers
public LoadQueryInfluencers getLoadQueryInfluencers()
Description copied from interface:SharedSessionContractImplementor
Get theLoadQueryInfluencers
associated with this session.- Specified by:
getLoadQueryInfluencers
in interfaceSharedSessionContractImplementor
- Returns:
- the
LoadQueryInfluencers
associated with this session; should never be null.
-
getExceptionConverter
public ExceptionConverter getExceptionConverter()
Description copied from interface:SharedSessionContractImplementor
Obtain anExceptionConverter
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 interfaceSharedSessionContractImplementor
- Returns:
- the ExceptionConverter for this Session.
-
getPersistenceContextInternal
public PersistenceContext getPersistenceContextInternal()
Description copied from interface:SharedSessionContractImplementor
Similar toSharedSessionContractImplementor.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.
- Specified by:
getPersistenceContextInternal
in interfaceSharedSessionContractImplementor
- 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 interfaceSharedSessionContractImplementor
- Parameters:
querySpaces
- the tables named in the query.- Returns:
- true if flush is required, false otherwise.
- Throws:
HibernateException
-
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 interfaceSharedSessionContractImplementor
- Parameters:
success
-true
if the operation a success
-
getEventListenerManager
public SessionEventListenerManager getEventListenerManager()
Description copied from interface:SharedSessionContractImplementor
Get theSessionEventListenerManager
associated with this session.- Specified by:
getEventListenerManager
in interfaceSharedSessionContractImplementor
-
accessTransaction
public Transaction accessTransaction()
Description copied from interface:SharedSessionContractImplementor
Retrieves the currentTransaction
, or creates a new transaction if there is no transaction active.This method is primarily for internal or integrator use.
- Specified by:
accessTransaction
in interfaceSharedSessionContractImplementor
- Returns:
- the
Transaction
-
beginTransaction
public Transaction beginTransaction()
Description copied from interface:SharedSessionContract
Begin a unit of work and return the associatedTransaction
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 interfaceSharedSessionContract
- Returns:
- a
Transaction
instance - See Also:
SharedSessionContract.getTransaction()
-
getTransaction
public Transaction getTransaction()
Description copied from interface:SharedSessionContract
Get theTransaction
instance associated with this session.- Specified by:
getTransaction
in interfaceEntityManager
- Specified by:
getTransaction
in interfaceSharedSessionContract
- 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 HibernateTransaction
API or via registration of Hibernate's JTA Synchronization impl with a JTA Transaction- Specified by:
startTransactionBoundary
in interfaceJdbcSessionOwner
-
getCacheTransactionSynchronization
public CacheTransactionSynchronization getCacheTransactionSynchronization()
Description copied from interface:SharedSessionContractImplementor
The currentCacheTransactionSynchronization
associated with this session. This may benull
if the session is not currently associated with an active transaction.- Specified by:
getCacheTransactionSynchronization
in interfaceSharedSessionContractImplementor
-
afterTransactionBegin
public void afterTransactionBegin()
Description copied from interface:JdbcSessionOwner
A after-begin callback from the coordinator to its owner.- Specified by:
afterTransactionBegin
in interfaceJdbcSessionOwner
-
beforeTransactionCompletion
public void beforeTransactionCompletion()
Description copied from interface:JdbcSessionOwner
A before-completion callback to the owner.- Specified by:
beforeTransactionCompletion
in interfaceJdbcSessionOwner
-
afterTransactionCompletion
public void afterTransactionCompletion(boolean successful, boolean delayed)
Description copied from interface:JdbcSessionOwner
An after-completion callback to the owner.- Specified by:
afterTransactionCompletion
in interfaceJdbcSessionOwner
- 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 interfaceJdbcSessionOwner
-
getEntityManagerFactory
public EntityManagerFactory getEntityManagerFactory()
- Specified by:
getEntityManagerFactory
in interfaceEntityManager
-
getCriteriaBuilder
public HibernateCriteriaBuilder getCriteriaBuilder()
Description copied from interface:SharedSessionContract
- Specified by:
getCriteriaBuilder
in interfaceEntityManager
- Specified by:
getCriteriaBuilder
in interfaceSharedSessionContract
- Returns:
- an instance of
HibernateCriteriaBuilder
- See Also:
SessionFactory.getCriteriaBuilder()
-
getMetamodel
public Metamodel getMetamodel()
- Specified by:
getMetamodel
in interfaceEntityManager
-
createEntityGraph
public <T> RootGraphImplementor<T> createEntityGraph(Class<T> rootType)
- Specified by:
createEntityGraph
in interfaceEntityManager
- Specified by:
createEntityGraph
in interfaceSession
- Specified by:
createEntityGraph
in interfaceSessionImplementor
-
createEntityGraph
public RootGraphImplementor<?> createEntityGraph(String graphName)
- Specified by:
createEntityGraph
in interfaceEntityManager
- Specified by:
createEntityGraph
in interfaceSession
- Specified by:
createEntityGraph
in interfaceSessionImplementor
-
getEntityGraph
public RootGraphImplementor<?> getEntityGraph(String graphName)
- Specified by:
getEntityGraph
in interfaceEntityManager
- Specified by:
getEntityGraph
in interfaceSession
- Specified by:
getEntityGraph
in interfaceSessionImplementor
-
getEntityGraphs
public <T> List<EntityGraph<? super T>> getEntityGraphs(Class<T> entityClass)
- Specified by:
getEntityGraphs
in interfaceEntityManager
- Specified by:
getEntityGraphs
in interfaceSession
-
createMutationQuery
public MutationQuery createMutationQuery(CriteriaUpdate updateQuery)
Description copied from interface:QueryProducer
Create aMutationQuery
from the given update criteria tree- Specified by:
createMutationQuery
in interfaceQueryProducer
- Specified by:
createMutationQuery
in interfaceQueryProducerImplementor
-
createMutationQuery
public MutationQuery createMutationQuery(CriteriaDelete deleteQuery)
Description copied from interface:QueryProducer
Create aMutationQuery
from the given delete criteria tree- Specified by:
createMutationQuery
in interfaceQueryProducer
- Specified by:
createMutationQuery
in interfaceQueryProducerImplementor
-
createMutationQuery
public MutationQuery createMutationQuery(JpaCriteriaInsertSelect insertSelect)
Description copied from interface:QueryProducer
Create aMutationQuery
from the given insert-select criteria tree- Specified by:
createMutationQuery
in interfaceQueryProducer
-
createQuery
public <T> QueryImplementor<T> createQuery(CriteriaQuery<T> criteriaQuery)
Description copied from interface:QueryProducer
Create aQuery
for the given JPACriteriaQuery
.- Specified by:
createQuery
in interfaceEntityManager
- Specified by:
createQuery
in interfaceQueryProducer
- Specified by:
createQuery
in interfaceQueryProducerImplementor
- Specified by:
createQuery
in interfaceSession
-
createQuery
public QueryImplementor createQuery(CriteriaUpdate updateQuery)
Description copied from interface:Session
Create aQuery
for the given JPACriteriaUpdate
.- Specified by:
createQuery
in interfaceEntityManager
- Specified by:
createQuery
in interfaceQueryProducer
- Specified by:
createQuery
in interfaceQueryProducerImplementor
- Specified by:
createQuery
in interfaceSession
-
createQuery
public QueryImplementor createQuery(CriteriaDelete deleteQuery)
Description copied from interface:Session
Create aQuery
for the given JPACriteriaDelete
.- Specified by:
createQuery
in interfaceEntityManager
- Specified by:
createQuery
in interfaceQueryProducer
- Specified by:
createQuery
in interfaceQueryProducerImplementor
- Specified by:
createQuery
in interfaceSession
-
getNamedQuery
public QueryImplementor getNamedQuery(String name)
Description copied from interface:QueryProducer
Create aQuery
instance for the named query.- Specified by:
getNamedQuery
in interfaceQueryProducer
- Specified by:
getNamedQuery
in interfaceQueryProducerImplementor
- Parameters:
name
- the name of a pre-defined, named query- Returns:
- The
Query
instance for manipulation and execution
-
getNamedNativeQuery
public NativeQueryImplementor getNamedNativeQuery(String name)
Description copied from interface:QueryProducer
Get aNativeQuery
instance for a named native SQL query- Specified by:
getNamedNativeQuery
in interfaceQueryProducer
- Specified by:
getNamedNativeQuery
in interfaceQueryProducerImplementor
- Parameters:
name
- The name of the pre-defined query- Returns:
- The
NativeQuery
instance for manipulation and execution
-
getNamedNativeQuery
public NativeQueryImplementor getNamedNativeQuery(String name, String resultSetMapping)
Description copied from interface:QueryProducer
Get aNativeQuery
instance for a named native SQL query- Specified by:
getNamedNativeQuery
in interfaceQueryProducer
- Specified by:
getNamedNativeQuery
in interfaceQueryProducerImplementor
- Parameters:
name
- The name of the pre-defined query- Returns:
- The
NativeQuery
instance for manipulation and execution
-
createQuery
public QueryImplementor createQuery(String queryString)
Description copied from interface:QueryProducer
Create aQuery
instance for the given HQL query, or HQL insert, update, or delete statement.- Specified by:
createQuery
in interfaceEntityManager
- Specified by:
createQuery
in interfaceQueryProducer
- Specified by:
createQuery
in interfaceQueryProducerImplementor
- Specified by:
createQuery
in interfaceSession
- 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 aSelectionQuery
reference for the given HQL. Only valid for select queries- Specified by:
createSelectionQuery
in interfaceQueryProducer
- See Also:
EntityManager.createQuery(String)
-
createSelectionQuery
public <R> SelectionQuery<R> createSelectionQuery(String hqlString, Class<R> resultType)
Description copied from interface:QueryProducer
Create aSelectionQuery
reference for the given HQL. Only valid for select queries- Specified by:
createSelectionQuery
in interfaceQueryProducer
- See Also:
EntityManager.createQuery(String)
-
createSelectionQuery
public <R> SelectionQuery<R> createSelectionQuery(CriteriaQuery<R> criteria)
Description copied from interface:QueryProducer
Create aSelectionQuery
reference for the given Criteria.- Specified by:
createSelectionQuery
in interfaceQueryProducer
- See Also:
EntityManager.createQuery(CriteriaQuery)
-
createQuery
public <T> QueryImplementor<T> createQuery(String queryString, Class<T> resultType)
Description copied from interface:QueryProducer
Create a typedQuery
instance for the given HQL query string.The returned
Query
may be executed by callingQuery.getResultList()
orQuery.getSingleResult()
.- Specified by:
createQuery
in interfaceEntityManager
- Specified by:
createQuery
in interfaceQueryProducer
- Specified by:
createQuery
in interfaceQueryProducerImplementor
- Specified by:
createQuery
in interfaceSession
- Parameters:
queryString
- The HQL queryresultType
- 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 typedQuery
instance for the given named query. The named query might be defined in HQL or in native SQL.- Specified by:
createNamedQuery
in interfaceEntityManager
- Specified by:
createNamedQuery
in interfaceQueryProducer
- Specified by:
createNamedQuery
in interfaceQueryProducerImplementor
- Specified by:
createNamedQuery
in interfaceSession
- Parameters:
name
- the name of a pre-defined, 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 typedQuery
instance for the given named query. The named query might be defined in HQL or in native SQL.- Specified by:
createNamedQuery
in interfaceEntityManager
- Specified by:
createNamedQuery
in interfaceQueryProducer
- Specified by:
createNamedQuery
in interfaceQueryProducerImplementor
- Specified by:
createNamedQuery
in interfaceSession
- Parameters:
name
- the name of a query defined in metadataresultClass
- 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 aSelectionQuery
instance for the namedNamedQuery
- Specified by:
createNamedSelectionQuery
in interfaceQueryProducer
-
createNamedSelectionQuery
public <R> SelectionQuery<R> createNamedSelectionQuery(String name, Class<R> resultType)
Description copied from interface:QueryProducer
Create aSelectionQuery
instance for the namedNamedQuery
with the expected result-type- Specified by:
createNamedSelectionQuery
in interfaceQueryProducer
-
createNativeQuery
public NativeQueryImplementor createNativeQuery(String sqlString)
Description copied from interface:QueryProducer
Create aNativeQuery
instance for the given native SQL query.- Specified by:
createNativeQuery
in interfaceEntityManager
- Specified by:
createNativeQuery
in interfaceQueryProducer
- Specified by:
createNativeQuery
in interfaceQueryProducerImplementor
- 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 aNativeQuery
instance for the given native SQL query using implicit mapping to the specified Java type.If the given class is an entity class, this method is equivalent to
createNativeQuery(sqlString).addEntity("alias1", resultClass)
.- Specified by:
createNativeQuery
in interfaceEntityManager
- Specified by:
createNativeQuery
in interfaceQueryProducer
- Specified by:
createNativeQuery
in interfaceQueryProducerImplementor
- Parameters:
sqlString
- The native (SQL) query stringresultClass
- The Java entity 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 aNativeQuery
instance for the given native SQL query using implicit mapping to the specified Java type.If the given class is an entity class, this method is equivalent to
createNativeQuery(sqlString).addEntity(tableAlias, resultClass)
.- Specified by:
createNativeQuery
in interfaceQueryProducer
- Specified by:
createNativeQuery
in interfaceQueryProducerImplementor
- Parameters:
sqlString
- Native (SQL) query stringresultClass
- The Java entity type to map results totableAlias
- 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 aNativeQuery
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 interfaceEntityManager
- Specified by:
createNativeQuery
in interfaceQueryProducer
- Specified by:
createNativeQuery
in interfaceQueryProducerImplementor
- Parameters:
sqlString
- The native (SQL) query stringresultSetMappingName
- 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 aNativeQuery
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 interfaceQueryProducer
- Specified by:
createNativeQuery
in interfaceQueryProducerImplementor
- Parameters:
sqlString
- The native (SQL) query stringresultSetMappingName
- 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 interfaceQueryProducer
- Specified by:
createMutationQuery
in interfaceQueryProducerImplementor
-
createNamedMutationQuery
public MutationQuery createNamedMutationQuery(String name)
Description copied from interface:QueryProducer
Create aMutationQuery
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 interfaceQueryProducer
- Specified by:
createNamedMutationQuery
in interfaceQueryProducerImplementor
-
createNativeMutationQuery
public MutationQuery createNativeMutationQuery(String sqlString)
Description copied from interface:QueryProducer
Create aNativeQuery
instance for the given native SQL statement.- Specified by:
createNativeMutationQuery
in interfaceQueryProducer
- Specified by:
createNativeMutationQuery
in interfaceQueryProducerImplementor
- 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 aProcedureCall
based on a named template- Specified by:
createNamedStoredProcedureQuery
in interfaceEntityManager
- Specified by:
createNamedStoredProcedureQuery
in interfaceSharedSessionContract
- 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 aProcedureCall
to a stored procedure.- Specified by:
createStoredProcedureQuery
in interfaceEntityManager
- Specified by:
createStoredProcedureQuery
in interfaceSharedSessionContract
- 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 aProcedureCall
to a stored procedure with the given result set entity mappings. Each given class is considered a "root return".- Specified by:
createStoredProcedureQuery
in interfaceEntityManager
- Specified by:
createStoredProcedureQuery
in interfaceSharedSessionContract
- 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 aProcedureCall
to a stored procedure with the given result set entity mappings.- Specified by:
createStoredProcedureQuery
in interfaceEntityManager
- Specified by:
createStoredProcedureQuery
in interfaceSharedSessionContract
- 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 aQuery
orProcedureCall
- Specified by:
prepareForQueryExecution
in interfaceSharedSessionContractImplementor
-
joinTransaction
public void joinTransaction()
Description copied from interface:SharedSessionContract
Join the currently-active JTA transaction.- Specified by:
joinTransaction
in interfaceEntityManager
- Specified by:
joinTransaction
in interfaceSharedSessionContract
- 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 interfaceEntityManager
- Specified by:
isJoinedToTransaction
in interfaceSharedSessionContract
- See Also:
SharedSessionContract.joinTransaction()
,EntityManager.isJoinedToTransaction()
-
unwrap
public <T> T unwrap(Class<T> cls)
- Specified by:
unwrap
in interfaceEntityManager
-
getDelegate
public Object getDelegate()
This is the implementation ofEntityManager.getDelegate()
. It returns this object and not what we call the "delegate" session here. To get the delegate session, usedelegate()
instead.- Specified by:
getDelegate
in interfaceEntityManager
- See Also:
delegate()
-
getNamedProcedureCall
public ProcedureCall getNamedProcedureCall(String name)
Description copied from interface:SharedSessionContract
Obtain aProcedureCall
based on a named template- Specified by:
getNamedProcedureCall
in interfaceSharedSessionContract
- 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 aProcedureCall
to a stored procedure.- Specified by:
createStoredProcedureCall
in interfaceSharedSessionContract
- 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 aProcedureCall
to a stored procedure with the given result set entity mappings. Each given class is considered a "root return".- Specified by:
createStoredProcedureCall
in interfaceSharedSessionContract
- 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 aProcedureCall
to a stored procedure with the given result set entity mappings.- Specified by:
createStoredProcedureCall
in interfaceSharedSessionContract
- 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 aSession
builder with the ability to copy certain information from this session.- Specified by:
sessionWithOptions
in interfaceSession
- 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 interfaceSession
- Specified by:
getSessionFactory
in interfaceSessionImplementor
- Specified by:
getSessionFactory
in interfaceSharedSessionContractImplementor
- Specified by:
getSessionFactory
in interfaceWrapperOptions
- 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 interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Specified by:
close
in interfaceEntityManager
- Specified by:
close
in interfaceSharedSessionContract
- 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 interfaceSession
- 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 interfaceSession
- 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 interfaceSession
- Specified by:
isDefaultReadOnly
in interfaceSharedSessionContractImplementor
- 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
useQuery.setReadOnly(boolean)
.- Specified by:
setDefaultReadOnly
in interfaceSession
- 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 interfaceSession
- 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.
-
contains
public boolean contains(Object object)
- Specified by:
contains
in interfaceEntityManager
-
getLockMode
public LockModeType getLockMode(Object entity)
- Specified by:
getLockMode
in interfaceEntityManager
-
setProperty
public void setProperty(String propertyName, Object value)
- Specified by:
setProperty
in interfaceEntityManager
-
getProperties
public Map<String,Object> getProperties()
- Specified by:
getProperties
in interfaceEntityManager
-
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 withCascadeType.DETACH
.This operation is a synonym for
Session.detach(Object)
.
-
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 interfaceSession
- Parameters:
theClass
- a persistent classid
- a valid identifier of an existing persistent instance of the classlockMode
- 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.
-
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 interfaceSession
- Parameters:
entityName
- the entity nameid
- a valid identifier of an existing persistent instance of the classlockMode
- 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.
-
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)
.
-
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.
-
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.
-
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 withCascadeType.REPLICATE
.
-
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 withCascadeType.REPLICATE
.
-
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 theassigned
generator is used.) This operation cascades to associated instances if the association is mapped withCascadeType.SAVE_UPDATE
.This operation is very similar to
Session.persist(Object)
.
-
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 theassigned
generator is used.) This operation cascades to associated instances if the association is mapped withCascadeType.SAVE_UPDATE
.
-
saveOrUpdate
public void saveOrUpdate(Object object)
Description copied from interface:Session
EitherSession.save(Object)
orSession.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 interfaceSession
- 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
EitherSession.save(String, Object)
orSession.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 interfaceSession
- Parameters:
entityName
- the entity nameobject
- 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 withCascadeType.SAVE_UPDATE
.
-
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 withCascadeType.SAVE_UPDATE
.
-
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 withCascadeType.MERGE
.- Specified by:
merge
in interfaceEntityManager
- Specified by:
merge
in interfaceSession
- 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 withCascadeType.MERGE
.
-
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 withCascadeType.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 interfaceEntityManager
- Specified by:
persist
in interfaceSession
- 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 mappedCascadeType.REMOVE
.- Specified by:
remove
in interfaceEntityManager
- Specified by:
remove
in interfaceSession
- Parameters:
entity
- the managed persistent instance to remove
-
find
public <T> T find(Class<T> entityClass, Object primaryKey)
- Specified by:
find
in interfaceEntityManager
-
find
public <T> T find(Class<T> entityClass, Object primaryKey, Map<String,Object> properties)
- Specified by:
find
in interfaceEntityManager
-
find
public <T> T find(Class<T> entityClass, Object primaryKey, LockModeType lockMode)
- Specified by:
find
in interfaceEntityManager
-
find
public <T> T find(Class<T> entityClass, Object primaryKey, LockModeType lockMode, Map<String,Object> properties)
- Specified by:
find
in interfaceEntityManager
-
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.- Specified by:
getReference
in interfaceEntityManager
- Specified by:
getReference
in interfaceSession
- Parameters:
entityClass
- the entity typeid
- 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 interfaceSession
- Parameters:
entityName
- the entity nameid
- 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 withCascadeType.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.
-
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 receivingSession
or a transient instance with an identifier associated with existing persistent state. This operation cascades to associated instances if the association is mapped withCascadeType.REMOVE
.
-
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 receivingSession
or a transient instance with an identifier associated with existing persistent state. This operation cascades to associated instances if the association is mapped withCascadeType.REMOVE
.
-
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 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
. - perform a version check with
-
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
. - perform a version check with
-
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 interfaceSessionImplementor
-
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 givenlock options
.This operation cascades to associated instances if the association is mapped with
CascadeType.LOCK
.
-
buildLockRequest
@Deprecated public Session.LockRequest buildLockRequest(LockOptions lockOptions)
Deprecated.Description copied from interface:Session
Build a newlock 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 interfaceSession
- Parameters:
lockOptions
- contains the lock level- Returns:
- a
Session.LockRequest
that can be used to lock any given object.
- the
-
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
- after inserting a
Blob
orClob
This operation cascades to associated instances if the association is mapped with
CascadeType.REFRESH
.This operation requests
LockMode.READ
. To obtain a stronger lock, callSession.refresh(Object, LockMode)
.- Specified by:
refresh
in interfaceEntityManager
- Specified by:
refresh
in interfaceSession
- Parameters:
object
- a persistent or detached instance
-
refresh
public void refresh(Object entity, Map<String,Object> properties)
- Specified by:
refresh
in interfaceEntityManager
-
refresh
public void refresh(Object entity, LockModeType lockMode)
- Specified by:
refresh
in interfaceEntityManager
-
refresh
public void refresh(Object entity, LockModeType lockMode, Map<String,Object> properties)
- Specified by:
refresh
in interfaceEntityManager
-
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
- after inserting a
Blob
orClob
This operation cascades to associated instances if the association is mapped with
CascadeType.REFRESH
.
-
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 givenLockMode
.Convenient form of
Session.refresh(Object, LockOptions)
- Specified by:
refresh
in interfaceSession
- Parameters:
object
- a persistent or detached instancelockMode
- 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 givenLockMode
.
-
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 givenLockMode
.
-
getCurrentLockMode
public LockMode getCurrentLockMode(Object object)
Description copied from interface:Session
Determine the currentLockMode
of the given managed instance associated with this session.- Specified by:
getCurrentLockMode
in interfaceSession
- Parameters:
object
- a persistent instance- 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 ofScrollableResults
.- Specified by:
clear
in interfaceEntityManager
- Specified by:
clear
in interfaceSession
-
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 withCascadeType.DETACH
.- Specified by:
detach
in interfaceEntityManager
- Specified by:
detach
in interfaceSession
- 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)
.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 modeLockMode.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 modeLockMode.READ
, or - set the cache mode to
CacheMode.IGNORE
before calling this method.
- call
-
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 interfaceSession
- Parameters:
theClass
- the entity typeid
- an identifierlockMode
- 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.
-
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.
-
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 interfaceSession
- Parameters:
entityName
- the entity nameid
- an identifierlockMode
- 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.
-
getEntityName
public String getEntityName(Object object)
Description copied from interface:Session
Return the entity name for a persistent entity.- Specified by:
getEntityName
in interfaceSession
- 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 interfaceSession
- 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 anIdentifierLoadAccess
instance to retrieve the specified entity type by primary key.
-
byMultipleIds
public <T> MultiIdentifierLoadAccess<T> byMultipleIds(Class<T> entityClass)
Description copied from interface:Session
Create aMultiIdentifierLoadAccess
instance to retrieve multiple entities at once as specified by primary key values.- Specified by:
byMultipleIds
in interfaceSession
- Parameters:
entityClass
- the entity type to be retrieved- Returns:
- load delegate for loading the specified entity type by primary key values
-
byMultipleIds
public <T> MultiIdentifierLoadAccess<T> byMultipleIds(String entityName)
Description copied from interface:Session
Create aMultiIdentifierLoadAccess
instance to retrieve multiple entities at once as specified by primary key values.- Specified by:
byMultipleIds
in interfaceSession
- Parameters:
entityName
- the entity name of the entity type to be retrieved- Returns:
- load delegate for loading the specified entity type by primary key values
-
byId
public <T> IdentifierLoadAccess<T> byId(Class<T> entityClass)
Description copied from interface:Session
Create anIdentifierLoadAccess
instance to retrieve the specified entity by primary key.
-
byNaturalId
public <T> NaturalIdLoadAccess<T> byNaturalId(String entityName)
Description copied from interface:Session
Create aNaturalIdLoadAccess
instance to retrieve the specified entity by its natural id.- Specified by:
byNaturalId
in interfaceSession
- Parameters:
entityName
- the entity name of the entity type to be retrieved- Returns:
- load delegate for loading the specified entity type by natural id
-
byNaturalId
public <T> NaturalIdLoadAccess<T> byNaturalId(Class<T> entityClass)
Description copied from interface:Session
Create aNaturalIdLoadAccess
instance to retrieve the specified entity by its natural id.- Specified by:
byNaturalId
in interfaceSession
- Parameters:
entityClass
- the entity type to be retrieved- Returns:
- load delegate for loading the specified entity type by natural id
-
bySimpleNaturalId
public <T> SimpleNaturalIdLoadAccess<T> bySimpleNaturalId(String entityName)
Description copied from interface:Session
Create aSimpleNaturalIdLoadAccess
instance to retrieve the specified entity by itsnatural id
.- Specified by:
bySimpleNaturalId
in interfaceSession
- Parameters:
entityName
- the entity name of the entity type to be retrieved- Returns:
- load delegate for loading the specified entity type by natural id
-
bySimpleNaturalId
public <T> SimpleNaturalIdLoadAccess<T> bySimpleNaturalId(Class<T> entityClass)
Description copied from interface:Session
Create aSimpleNaturalIdLoadAccess
instance to retrieve the specified entity by its simple (single attribute)natural id
.- Specified by:
bySimpleNaturalId
in interfaceSession
- Parameters:
entityClass
- the entity type to be retrieved- Returns:
- load delegate for loading the specified entity type by natural id
-
byMultipleNaturalId
public <T> NaturalIdMultiLoadAccess<T> byMultipleNaturalId(Class<T> entityClass)
Description copied from interface:Session
Access to load multiple entities bynatural id
.- Specified by:
byMultipleNaturalId
in interfaceSession
-
byMultipleNaturalId
public <T> NaturalIdMultiLoadAccess<T> byMultipleNaturalId(String entityName)
Description copied from interface:Session
Access to load multiple entities bynatural id
.- Specified by:
byMultipleNaturalId
in interfaceSession
-
enableFilter
public Filter enableFilter(String filterName)
Description copied from interface:Session
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 interfaceSession
- 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:Session
Retrieve a currently enabled filter by name.- Specified by:
getEnabledFilter
in interfaceSession
- 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:Session
Disable the named filter for the current session.- Specified by:
disableFilter
in interfaceSession
- 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 interfaceSession
- 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 interfaceSession
- 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
useQuery.setReadOnly(boolean)
- Specified by:
setReadOnly
in interfaceSession
- Parameters:
entityOrProxy
- an entity or proxyreadOnly
-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)
-
doWork
public void doWork(Work work) throws HibernateException
Description copied from interface:SharedSessionContract
Perform work using theConnection
underlying by this session.- Specified by:
doWork
in interfaceSharedSessionContract
- Parameters:
work
- The work to be performed.- Throws:
HibernateException
- Generally indicates wrappedSQLException
-
doReturningWork
public <T> T doReturningWork(ReturningWork<T> work) throws HibernateException
Description copied from interface:SharedSessionContract
Perform work using theConnection
underlying by this session, and return a result.- Specified by:
doReturningWork
in interfaceSharedSessionContract
- 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 wrappedSQLException
-
isFetchProfileEnabled
public boolean isFetchProfileEnabled(String name) throws UnknownProfileException
Description copied from interface:Session
Is thefetch profile
with the given name enabled in this session?- Specified by:
isFetchProfileEnabled
in interfaceSession
- 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 thefetch 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 interfaceSession
- 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 thefetch 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 interfaceSession
- 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
- Specified by:
getLobHelper
in interfaceSession
- 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 interfaceSession
- Parameters:
listeners
- the listener(s) to add
-
getActionQueue
public ActionQueue getActionQueue()
Description copied from interface:SessionImplementor
Get theActionQueue
associated with this session.- Specified by:
getActionQueue
in interfaceSessionImplementor
-
instantiate
public Object instantiate(EntityPersister persister, Object id) throws HibernateException
Description copied from interface:SharedSessionContractImplementor
Instantiate the entity class of the givenEntityPersister
, 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 interfaceSessionImplementor
- Specified by:
instantiate
in interfaceSharedSessionContractImplementor
- 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 interfaceSessionImplementor
- 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 interfaceSessionImplementor
- Throws:
HibernateException
-
merge
public void merge(String entityName, Object object, MergeContext copiedAlready) throws HibernateException
- Specified by:
merge
in interfaceSessionImplementor
- Throws:
HibernateException
-
persist
public void persist(String entityName, Object object, PersistContext createdAlready) throws HibernateException
- Specified by:
persist
in interfaceSessionImplementor
- Throws:
HibernateException
-
persistOnFlush
public void persistOnFlush(String entityName, Object object, PersistContext copiedAlready)
- Specified by:
persistOnFlush
in interfaceSessionImplementor
-
refresh
public void refresh(String entityName, Object object, RefreshContext refreshedAlready) throws HibernateException
- Specified by:
refresh
in interfaceSessionImplementor
- Throws:
HibernateException
-
delete
public void delete(String entityName, Object child, boolean isCascadeDeleteEnabled, DeleteContext transientEntities)
- Specified by:
delete
in interfaceSessionImplementor
-
removeOrphanBeforeUpdates
public void removeOrphanBeforeUpdates(String entityName, Object child)
- Specified by:
removeOrphanBeforeUpdates
in interfaceSessionImplementor
-
getSession
public SessionImplementor getSession()
Description copied from interface:SharedSessionContractImplementor
Returns this object, fulfilling the contract ofWrapperOptions
.- Specified by:
getSession
in interfaceSessionImplementor
- Specified by:
getSession
in interfaceSharedSessionContractImplementor
- Specified by:
getSession
in interfaceWrapperOptions
-
useStreamForLobBinding
public boolean useStreamForLobBinding()
Description copied from interface:WrapperOptions
Determines whether streams should be used for binding LOB values.- Specified by:
useStreamForLobBinding
in interfaceWrapperOptions
- Returns:
true
/false
- See Also:
Dialect.useInputStreamToInsertBlob()
-
getPreferredSqlTypeCodeForBoolean
public int getPreferredSqlTypeCodeForBoolean()
Description copied from interface:WrapperOptions
The JDBCtype code
used to bind a null boolean value.- Specified by:
getPreferredSqlTypeCodeForBoolean
in interfaceWrapperOptions
- See Also:
AvailableSettings.PREFERRED_BOOLEAN_JDBC_TYPE
,Dialect.getPreferredSqlTypeCodeForBoolean()
-
getLobCreator
public LobCreator getLobCreator()
Description copied from interface:WrapperOptions
Obtain access to theLobCreator
.- Specified by:
getLobCreator
in interfaceWrapperOptions
- Returns:
- The LOB creator
- See Also:
AvailableSettings.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 interfaceJdbcSessionOwner
- Specified by:
getJdbcBatchSize
in interfaceSharedSessionContract
- Returns:
- the current session-level JDBC batch size
- See Also:
SessionFactoryOptions.getJdbcBatchSize()
,SessionFactoryBuilder.applyJdbcBatchSize(int)
-
setJdbcBatchSize
public void setJdbcBatchSize(Integer jdbcBatchSize)
Description copied from interface:SharedSessionContract
Set the session-level JDBC batch size. Overrides thefactory-level
JDBC batch size defined by the configuration property "hibernate.jdbc.batch_size".- Specified by:
setJdbcBatchSize
in interfaceSharedSessionContract
- Parameters:
jdbcBatchSize
- the new session-level JDBC batch size- See Also:
SessionFactoryOptions.getJdbcBatchSize()
,SessionFactoryBuilder.applyJdbcBatchSize(int)
-
getJdbcTimeZone
public TimeZone getJdbcTimeZone()
Description copied from interface:WrapperOptions
The JDBCTimeZone
used when writing a value of typeTime
orTimestamp
to a JDBCPreparedStatement
, or when reading from a JDBCResultSet
.- When
getJdbcTimeZone()
is null, the methodPreparedStatement.setTimestamp(int, java.sql.Timestamp)
is called to write a timestamp, andResultSet.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, andResultSet.getTimestamp(int, java.util.Calendar)
is called to read a timestamp.
Thus, the storage
TimeZone
can differ from the default JVM TimeZone given byTimeZone.getDefault()
.- Specified by:
getJdbcTimeZone
in interfaceWrapperOptions
- Returns:
- the JDBC
TimeZone
, or null if no JDBC timezone was explicitly set - See Also:
AvailableSettings.JDBC_TIME_ZONE
- When
-
-