Package org.hibernate.engine.spi
Interface SessionImplementor
- All Superinterfaces:
AutoCloseable
,EntityManager
,JavaType.CoercionContext
,JdbcSessionOwner
,LobCreationContext
,QueryProducer
,QueryProducerImplementor
,Serializable
,Session
,SharedSessionContract
,SharedSessionContractImplementor
,TransactionCoordinatorBuilder.Options
,WrapperOptions
- All Known Subinterfaces:
EventSource
- All Known Implementing Classes:
AbstractDelegateSessionImplementor
,SessionDelegatorBaseImpl
,SessionImpl
,ToOneDelegateSessionImplementor
Defines the "internal contract" between
Session
and other parts of Hibernate
including implementors of Type
, EntityPersister
,
and CollectionPersister
.
The Session
, via this interface and SharedSessionContractImplementor
,
implements:
-
JdbcSessionOwner
, and so the session also acts as the orchestrator of a "JDBC session", and may be used to construct aJdbcCoordinator
. -
TransactionCoordinatorBuilder.Options
, allowing the session to control the creation of theTransactionCoordinator
delegate when it is passed as an argument toTransactionCoordinatorBuilder.buildTransactionCoordinator(org.hibernate.resource.transaction.spi.TransactionCoordinatorOwner, org.hibernate.resource.transaction.spi.TransactionCoordinatorBuilder.Options)
-
LobCreationContext
, and so the session may act as the context for JDBC LOB instance creation. -
WrapperOptions
, and so the session may influence the process of binding and extracting values to and from JDBC, which is performed by implementors ofJdbcType
.
EventSource
which extends this interface,
providing a bridge to the event generation features of org.hibernate.event
.-
Nested Class Summary
Nested classes/interfaces inherited from interface org.hibernate.engine.jdbc.LobCreationContext
LobCreationContext.Callback<T>
-
Method Summary
Modifier and TypeMethodDescriptiondefault <C,
T> T callWithConnection
(ConnectionFunction<C, T> function) <T> QueryImplementor
<T> createQuery
(CriteriaSelect<T> selectQuery) void
Initiate a flush to force deletion of a re-persisted entity.void
Initiate a flush to force deletion of a re-persisted entity.Get theActionQueue
associated with this session.default SessionImplementor
Returns this object, fulfilling the contract ofWrapperOptions
.Get the session factory which created this session.instantiate
(EntityPersister persister, Object id) Instantiate the entity class of the givenEntityPersister
, initializing the new instance with the given identifier.default <C> void
runWithConnection
(ConnectionConsumer<C> action) Methods inherited from interface jakarta.persistence.EntityManager
close, contains, createNamedStoredProcedureQuery, createNativeQuery, createNativeQuery, createNativeQuery, createStoredProcedureQuery, createStoredProcedureQuery, createStoredProcedureQuery, find, find, find, find, find, getCriteriaBuilder, getDelegate, getEntityManagerFactory, getLockMode, getMetamodel, getProperties, getTransaction, isJoinedToTransaction, isOpen, joinTransaction, lock, lock, lock, refresh, refresh, refresh, refresh
Methods inherited from interface org.hibernate.resource.jdbc.spi.JdbcSessionOwner
afterObtainConnection, afterTransactionBegin, afterTransactionCompletion, beforeReleaseConnection, beforeTransactionCompletion, flushBeforeTransactionCompletion, getEventManager, getEventMonitor, getJdbcBatchSize, getJdbcConnectionAccess, getJdbcSessionContext, getSqlExceptionHelper, getTransactionCoordinator, startTransactionBoundary
Methods inherited from interface org.hibernate.engine.jdbc.LobCreationContext
execute, fromContext
Methods inherited from interface org.hibernate.query.QueryProducer
createMutationQuery, createNamedSelectionQuery, createNamedSelectionQuery, createSelectionQuery, createSelectionQuery, createSelectionQuery, createSelectionQuery
Methods inherited from interface org.hibernate.query.spi.QueryProducerImplementor
createMutationQuery, createMutationQuery, createMutationQuery, createNamedMutationQuery, createNamedQuery, createNamedQuery, createNativeMutationQuery, createNativeQuery, createNativeQuery, createNativeQuery, createNativeQuery, createNativeQuery, createQuery, createQuery, createQuery, createQuery, createQuery, createQuery, getCacheMode, getNamedNativeQuery, getNamedNativeQuery, getNamedQuery
Methods inherited from interface org.hibernate.Session
addEventListeners, byId, byId, byMultipleIds, byMultipleIds, byMultipleNaturalId, byMultipleNaturalId, byNaturalId, byNaturalId, bySimpleNaturalId, bySimpleNaturalId, cancelQuery, clear, contains, createEntityGraph, createEntityGraph, createNamedQuery, createNamedQuery, createQuery, createQuery, createQuery, createQuery, createQuery, createQuery, detach, disableFetchProfile, enableFetchProfile, evict, find, find, find, findMultiple, findMultiple, flush, get, get, get, get, get, get, getCacheMode, getCacheRetrieveMode, getCacheStoreMode, getCurrentLockMode, getEntityGraph, getEntityGraphs, getEntityName, getFetchBatchSize, getFlushMode, getHibernateFlushMode, getIdentifier, getLobHelper, getManagedEntities, getManagedEntities, getManagedEntities, getManagedEntities, getReference, getReference, getReference, getStatistics, isDefaultReadOnly, isDirty, isFetchProfileEnabled, isReadOnly, isSubselectFetchingEnabled, load, lock, lock, lock, merge, merge, merge, persist, persist, refresh, refresh, remove, replicate, replicate, sessionWithOptions, setCacheMode, setCacheRetrieveMode, setCacheStoreMode, setDefaultReadOnly, setFetchBatchSize, setFlushMode, setHibernateFlushMode, setProperty, setReadOnly, setSubselectFetchingEnabled, unwrap
Methods inherited from interface org.hibernate.SharedSessionContract
beginTransaction, close, createEntityGraph, createNamedStoredProcedureQuery, createStoredProcedureCall, createStoredProcedureCall, createStoredProcedureCall, createStoredProcedureQuery, createStoredProcedureQuery, createStoredProcedureQuery, disableFilter, doReturningWork, doWork, enableFilter, fromTransaction, getCriteriaBuilder, getEnabledFilter, getJdbcBatchSize, getNamedProcedureCall, getTenantIdentifier, getTenantIdentifierValue, getTransaction, inTransaction, isConnected, isJoinedToTransaction, isOpen, joinTransaction, setJdbcBatchSize
Methods inherited from interface org.hibernate.engine.spi.SharedSessionContractImplementor
accessTransaction, afterOperation, afterScrollOperation, asEventSource, asSessionImplementor, asStatelessSession, autoFlushIfRequired, autoFlushIfRequired, autoPreFlush, bestGuessEntityName, bestGuessEntityName, checkOpen, checkOpen, checkTransactionNeededForUpdateOperation, createEntityGraph, createEntityGraph, flush, generateEntityKey, getCacheTransactionSynchronization, getConfiguredJdbcBatchSize, getContextEntityIdentifier, getDialect, getEntityGraph, getEntityPersister, getEntityUsingInterceptor, getEventListenerManager, getExceptionConverter, getFactory, getHibernateFlushMode, getInterceptor, getJdbcCoordinator, getJdbcServices, getLoadQueryInfluencers, getNativeJdbcParametersIgnored, getPersistenceContext, getPersistenceContextInternal, getSessionAssociationMarkers, getSessionIdentifier, getSessionToken, getTypeConfiguration, guessEntityName, immediateLoad, initializeCollection, instantiate, internalLoad, isClosed, isCriteriaCopyTreeEnabled, isCriteriaPlanCacheEnabled, isDefaultReadOnly, isEventSource, isIdentifierRollbackEnabled, isOpenOrWaitingForAutoClose, isSessionImplementor, isStatelessSession, isTransactionInProgress, loadFromSecondLevelCache, lock, markForRollbackOnly, prepareForQueryExecution, registerProcess, setCriteriaCopyTreeEnabled, setCriteriaPlanCacheEnabled, setNativeJdbcParametersIgnored
Methods inherited from interface org.hibernate.resource.transaction.spi.TransactionCoordinatorBuilder.Options
shouldAutoJoinTransaction
Methods inherited from interface org.hibernate.type.descriptor.WrapperOptions
getJdbcTimeZone, getJsonFormatMapper, getLobCreator, getPreferredSqlTypeCodeForBoolean, getXmlFormatMapper, useStreamForLobBinding
-
Method Details
-
getSession
Description copied from interface:SharedSessionContractImplementor
Returns this object, fulfilling the contract ofWrapperOptions
.- Specified by:
getSession
in interfaceSharedSessionContractImplementor
- Specified by:
getSession
in interfaceWrapperOptions
-
getSessionFactory
SessionFactoryImplementor getSessionFactory()Description copied from interface:Session
Get the session factory which created this session.- Specified by:
getSessionFactory
in interfaceSession
- Specified by:
getSessionFactory
in interfaceSharedSessionContractImplementor
- Specified by:
getSessionFactory
in interfaceWrapperOptions
- Returns:
- the session factory
- See Also:
-
createQuery
- Specified by:
createQuery
in interfaceEntityManager
-
getActionQueue
ActionQueue getActionQueue()Get theActionQueue
associated with this session. -
instantiate
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 interfaceSharedSessionContractImplementor
- Throws:
HibernateException
-
forceFlush
Initiate a flush to force deletion of a re-persisted entity.- Throws:
HibernateException
-
forceFlush
Initiate a flush to force deletion of a re-persisted entity.- Throws:
HibernateException
-
runWithConnection
- Specified by:
runWithConnection
in interfaceEntityManager
-
callWithConnection
- Specified by:
callWithConnection
in interfaceEntityManager
-