Package org.hibernate.engine.creation.spi

Interface SharedSessionBuilderImplementor

All Superinterfaces:

CommonBuilder, CommonSharedBuilder, SessionBuilder, SessionBuilderImplementor, SharedSessionBuilder

public interface SharedSessionBuilderImplementor
extends SharedSessionBuilder, SessionBuilderImplementor

Since:

7.2

Method Summary

Modifier and Type	Method	Description
SharedSessionBuilderImplementor	autoClear(boolean autoClear)	Should the session be automatically cleared on a failed transaction?
SharedSessionBuilderImplementor	autoClose()	Signifies that the autoClose flag from the original session should be used to create the new session.
SharedSessionBuilderImplementor	autoClose(boolean autoClose)	Should the session be automatically closed after transaction completion?
SharedSessionBuilderImplementor	autoJoinTransactions()	Signifies that the autoJoinTransaction flag from the original session should be used to create the new session.
SharedSessionBuilderImplementor	autoJoinTransactions(boolean autoJoinTransactions)	Should the session built automatically join in any ongoing JTA transactions.
SharedSessionBuilderImplementor	clearEventListeners()	Remove all listeners intended for the built session currently held here, including any auto-apply ones; in other words, start with a clean slate.
SharedSessionBuilderImplementor	connection()	Signifies that the connection from the original session should be used to create the new session.
SharedSessionBuilderImplementor	connection(Connection connection)	Adds a specific connection to the session options.
SharedSessionBuilderImplementor	connectionHandling(ConnectionAcquisitionMode acquisitionMode, ConnectionReleaseMode releaseMode)	Specifies the connection handling modes for the session.
SharedSessionBuilderImplementor	connectionHandlingMode()	Signifies that the connection release mode from the original session should be used to create the new session.
SharedSessionBuilderImplementor	connectionHandlingMode(PhysicalConnectionHandlingMode mode)	Deprecated.
SharedSessionBuilderImplementor	connectionReleaseMode()	Deprecated.
SharedSessionBuilderImplementor	defaultBatchFetchSize(int defaultBatchFetchSize)	Specify the default batch fetch size for the session.
SharedSessionBuilderImplementor	eventListeners(SessionEventListener... listeners)	Add one or more SessionEventListener instances to the list of listeners for the new session to be built.
SharedSessionBuilderImplementor	flushMode()	Signifies that the FlushMode from the original session should be used to create the new session.
SharedSessionBuilderImplementor	flushMode(FlushMode flushMode)	Specify the initial FlushMode to use for the opened Session
SharedSessionBuilderImplementor	identifierRollback(boolean identifierRollback)	Enable identifier rollback after entity removal for the session.
SharedSessionBuilderImplementor	initialCacheMode(CacheMode cacheMode)	Specify the initial CacheMode for the session.
SharedSessionBuilderImplementor	interceptor()	Signifies the interceptor from the original session should be used to create the new session.
SharedSessionBuilderImplementor	interceptor(Interceptor interceptor)	Adds a specific interceptor to the session options.
SharedSessionBuilderImplementor	jdbcTimeZone(TimeZone timeZone)	Specify the JDBC time zone for the session.
SharedSessionBuilderImplementor	noInterceptor()	Specifies that no Interceptor should be used.
SharedSessionBuilderImplementor	noSessionInterceptorCreation()	Specifies that no session-scoped interceptor should be instantiated for the new session.
SharedSessionBuilderImplementor	noStatementInspector()	Signifies that no SQL statement inspector should be used.
SharedSessionBuilderImplementor	readOnly(boolean readOnly)	Specify a read-only mode for the session.
SharedSessionBuilderImplementor	statementInspector()	Signifies that the SQL statement inspector from the original session should be used.
SharedSessionBuilderImplementor	statementInspector(UnaryOperator<String> operator)	Applies the given statement inspection function to the session.
SharedSessionBuilderImplementor	statementInspector(StatementInspector statementInspector)	Applies the given StatementInspector to the session.
SharedSessionBuilderImplementor	subselectFetchEnabled(boolean subselectFetchEnabled)	Specify whether subselect fetching is enabled for the session.
SharedSessionBuilderImplementor	tenantIdentifier(Object tenantIdentifier)	Define the tenant identifier to be associated with the opened session.
SharedSessionBuilderImplementor	tenantIdentifier(String tenantIdentifier)	Deprecated, for removal: This API element is subject to removal in a future version.

Methods inherited from interface org.hibernate.engine.creation.spi.SessionBuilderImplementor

openSession

Method Details

interceptor

SharedSessionBuilderImplementor interceptor(Interceptor interceptor)

Description copied from interface: CommonBuilder

Adds a specific interceptor to the session options.

Specified by:

interceptor in interface CommonBuilder

Specified by:

interceptor in interface CommonSharedBuilder

Specified by:

interceptor in interface SessionBuilder

Specified by:

interceptor in interface SessionBuilderImplementor

Specified by:

interceptor in interface SharedSessionBuilder

Parameters:

interceptor - The interceptor to use.

Returns:

this, for method chaining

noInterceptor

SharedSessionBuilderImplementor noInterceptor()

Description copied from interface: CommonBuilder

Specifies that no Interceptor should be used.

By default, if no Interceptor is explicitly specified, the Interceptor associated with the SessionFactory is inherited by the new session. Or, if there is no interceptor associated with the SessionFactory, but a session-scoped interceptor has been configured, a new session-scoped Interceptor will be created for the new session.

Calling interceptor(null) has the same effect.

Specified by:

noInterceptor in interface CommonBuilder

Specified by:

noInterceptor in interface CommonSharedBuilder

Specified by:

noInterceptor in interface SessionBuilder

Specified by:

noInterceptor in interface SessionBuilderImplementor

Specified by:

noInterceptor in interface SharedSessionBuilder

Returns:

this, for method chaining

noSessionInterceptorCreation

SharedSessionBuilderImplementor noSessionInterceptorCreation()

Description copied from interface: CommonBuilder

Specifies that no session-scoped interceptor should be instantiated for the new session.

By default, if no Interceptor is explicitly specified, and if there is no interceptor associated with the SessionFactory, but a session-scoped interceptor has been configured, a new session-scoped Interceptor will be created for the new session.

Note that this operation does not disable use of an interceptor associated with the SessionFactory.

Specified by:

noSessionInterceptorCreation in interface CommonBuilder

Specified by:

noSessionInterceptorCreation in interface CommonSharedBuilder

Specified by:

noSessionInterceptorCreation in interface SessionBuilder

Specified by:

noSessionInterceptorCreation in interface SessionBuilderImplementor

Specified by:

noSessionInterceptorCreation in interface SharedSessionBuilder

Returns:

this, for method chaining

See Also:

• SessionEventSettings.SESSION_SCOPED_INTERCEPTOR

statementInspector

SharedSessionBuilderImplementor statementInspector(UnaryOperator<String> operator)

Description copied from interface: CommonBuilder

Applies the given statement inspection function to the session.

Specified by:

statementInspector in interface CommonBuilder

Specified by:

statementInspector in interface CommonSharedBuilder

Specified by:

statementInspector in interface SessionBuilder

Specified by:

statementInspector in interface SessionBuilderImplementor

Specified by:

statementInspector in interface SharedSessionBuilder

Parameters:

operator - An operator which accepts a SQL string, returning a processed SQL string to be used by Hibernate instead of the given original SQL. The operator may simply return the original SQL.

Returns:

this, for method chaining

statementInspector

SharedSessionBuilderImplementor statementInspector(StatementInspector statementInspector)

Description copied from interface: SessionBuilder

Applies the given StatementInspector to the session.

Specified by:

statementInspector in interface SessionBuilder

Specified by:

statementInspector in interface SessionBuilderImplementor

Specified by:

statementInspector in interface SharedSessionBuilder

Parameters:

statementInspector - The StatementInspector to use.

Returns:

this, for method chaining

tenantIdentifier

SharedSessionBuilderImplementor tenantIdentifier(Object tenantIdentifier)

Description copied from interface: SessionBuilder

Define the tenant identifier to be associated with the opened session.

Specified by:

tenantIdentifier in interface CommonBuilder

Specified by:

tenantIdentifier in interface CommonSharedBuilder

Specified by:

tenantIdentifier in interface SessionBuilder

Specified by:

tenantIdentifier in interface SessionBuilderImplementor

Specified by:

tenantIdentifier in interface SharedSessionBuilder

Parameters:

tenantIdentifier - The tenant identifier.

Returns:

this, for method chaining

readOnly

SharedSessionBuilderImplementor readOnly(boolean readOnly)

Description copied from interface: CommonBuilder

Specify a read-only mode for the session. If a session is created in read-only mode, then Connection.setReadOnly(boolean) is called when a JDBC connection is obtained.

Furthermore, if read/write replication is in use, then:

• a read-only session will connect to a read-only replica, but
• a non-read-only session will connect to a writable replica.

When read/write replication is in use, it's strongly recommended that the session be created with the initial cache mode set to CacheMode.GET, to avoid writing stale data read from a read-only replica to the second-level cache. Hibernate cannot possibly guarantee that data read from a read-only replica is up to date.

When read/write replication is in use, it's possible that an item read from the second-level cache might refer to data which does not yet exist in the read-only replica. In this situation, an exception occurs when the association is fetched. To completely avoid this possibility, the initial cache mode must be set to CacheMode.IGNORE. However, it's also usually possible to structure data access code in a way which eliminates this possibility.

 try (var readOnlySession =
         sessionFactory.withOptions()
                 .readOnly(true)
                 .initialCacheMode(CacheMode.IGNORE)
                 .openSession()) {
     ...
 }
 

If a session is created in read-only mode, then it cannot be changed to read-write mode, and any call to Session.setDefaultReadOnly(boolean) with fail. On the other hand, if a session is created in read-write mode, then it may later be switched to read-only mode, but all database access is directed to the writable replica.

Specified by:

readOnly in interface CommonBuilder

Specified by:

readOnly in interface CommonSharedBuilder

Specified by:

readOnly in interface SessionBuilder

Specified by:

readOnly in interface SessionBuilderImplementor

Specified by:

readOnly in interface SharedSessionBuilder

Returns:

this, for method chaining

See Also:

• MultiTenantConnectionProvider.getReadOnlyConnection(Object)
• MultiTenantConnectionProvider.releaseReadOnlyConnection(Object, Connection)

initialCacheMode

SharedSessionBuilderImplementor initialCacheMode(CacheMode cacheMode)

Description copied from interface: CommonBuilder

Specify the initial CacheMode for the session.

Specified by:

initialCacheMode in interface CommonBuilder

Specified by:

initialCacheMode in interface CommonSharedBuilder

Specified by:

initialCacheMode in interface SessionBuilder

Specified by:

initialCacheMode in interface SessionBuilderImplementor

Specified by:

initialCacheMode in interface SharedSessionBuilder

Returns:

this, for method chaining

See Also:

• SharedSessionContract.getCacheMode()

connection

SharedSessionBuilderImplementor connection()

Description copied from interface: CommonSharedBuilder

Signifies that the connection from the original session should be used to create the new session. Implies that the overall "transaction context" should be shared as well.

Specified by:

connection in interface CommonSharedBuilder

Specified by:

connection in interface SharedSessionBuilder

Returns:

this, for method chaining

interceptor

SharedSessionBuilderImplementor interceptor()

Description copied from interface: CommonSharedBuilder

Signifies the interceptor from the original session should be used to create the new session.

Specified by:

interceptor in interface CommonSharedBuilder

Specified by:

interceptor in interface SharedSessionBuilder

Returns:

this, for method chaining

connectionReleaseMode

@Deprecated
SharedSessionBuilderImplementor connectionReleaseMode()

Deprecated.

Description copied from interface: SharedSessionBuilder

Signifies that the connection release mode from the original session should be used to create the new session.

Specified by:

connectionReleaseMode in interface SharedSessionBuilder

Returns:

this, for method chaining

connectionHandlingMode

SharedSessionBuilderImplementor connectionHandlingMode()

Description copied from interface: SharedSessionBuilder

Signifies that the connection release mode from the original session should be used to create the new session.

Specified by:

connectionHandlingMode in interface SharedSessionBuilder

Returns:

this, for method chaining

autoJoinTransactions

SharedSessionBuilderImplementor autoJoinTransactions()

Description copied from interface: SharedSessionBuilder

Signifies that the autoJoinTransaction flag from the original session should be used to create the new session.

Specified by:

autoJoinTransactions in interface SharedSessionBuilder

Returns:

this, for method chaining

flushMode

SharedSessionBuilderImplementor flushMode()

Description copied from interface: SharedSessionBuilder

Signifies that the FlushMode from the original session should be used to create the new session.

Specified by:

flushMode in interface SharedSessionBuilder

Returns:

this, for method chaining

autoClose

SharedSessionBuilderImplementor autoClose()

Description copied from interface: SharedSessionBuilder

Signifies that the autoClose flag from the original session should be used to create the new session.

Specified by:

autoClose in interface SharedSessionBuilder

Returns:

this, for method chaining

connectionHandlingMode

@Deprecated
SharedSessionBuilderImplementor connectionHandlingMode(PhysicalConnectionHandlingMode mode)

Deprecated.

Description copied from interface: SessionBuilder

Specifies the connection handling mode.

Specified by:

connectionHandlingMode in interface SessionBuilder

Specified by:

connectionHandlingMode in interface SessionBuilderImplementor

Specified by:

connectionHandlingMode in interface SharedSessionBuilder

Parameters:

mode - The connection handling mode to use.

Returns:

this, for method chaining

connectionHandling

SharedSessionBuilderImplementor connectionHandling(ConnectionAcquisitionMode acquisitionMode,
 ConnectionReleaseMode releaseMode)

Description copied from interface: SessionBuilder

Specifies the connection handling modes for the session.

Note that if ConnectionAcquisitionMode.IMMEDIATELY is specified, then the release mode must be ConnectionReleaseMode.ON_CLOSE.

Specified by:

connectionHandling in interface CommonBuilder

Specified by:

connectionHandling in interface CommonSharedBuilder

Specified by:

connectionHandling in interface SessionBuilder

Specified by:

connectionHandling in interface SessionBuilderImplementor

Specified by:

connectionHandling in interface SharedSessionBuilder

Returns:

this, for method chaining

autoClear

SharedSessionBuilderImplementor autoClear(boolean autoClear)

Description copied from interface: SessionBuilder

Should the session be automatically cleared on a failed transaction?

Specified by:

autoClear in interface SessionBuilder

Specified by:

autoClear in interface SessionBuilderImplementor

Specified by:

autoClear in interface SharedSessionBuilder

Parameters:

autoClear - Whether the Session should be automatically cleared

Returns:

this, for method chaining

flushMode

SharedSessionBuilderImplementor flushMode(FlushMode flushMode)

Description copied from interface: SessionBuilder

Specify the initial FlushMode to use for the opened Session

Specified by:

flushMode in interface SessionBuilder

Specified by:

flushMode in interface SessionBuilderImplementor

Specified by:

flushMode in interface SharedSessionBuilder

Parameters:

flushMode - The initial FlushMode to use for the opened Session

Returns:

this, for method chaining

See Also:

• PersistenceContextType

tenantIdentifier

@Deprecated(forRemoval=true)
SharedSessionBuilderImplementor tenantIdentifier(String tenantIdentifier)

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

Description copied from interface: SessionBuilder

Define the tenant identifier to be associated with the opened session.

Specified by:

tenantIdentifier in interface SessionBuilder

Specified by:

tenantIdentifier in interface SessionBuilderImplementor

Specified by:

tenantIdentifier in interface SharedSessionBuilder

Parameters:

tenantIdentifier - The tenant identifier.

Returns:

this, for method chaining

eventListeners

SharedSessionBuilderImplementor eventListeners(SessionEventListener... listeners)

Description copied from interface: SessionBuilder

Add one or more SessionEventListener instances to the list of listeners for the new session to be built.

Specified by:

eventListeners in interface SessionBuilder

Specified by:

eventListeners in interface SessionBuilderImplementor

Specified by:

eventListeners in interface SharedSessionBuilder

Parameters:

listeners - The listeners to incorporate into the built Session

Returns:

this, for method chaining

clearEventListeners

SharedSessionBuilderImplementor clearEventListeners()

Description copied from interface: SessionBuilder

Remove all listeners intended for the built session currently held here, including any auto-apply ones; in other words, start with a clean slate.

Specified by:

clearEventListeners in interface SessionBuilder

Specified by:

clearEventListeners in interface SessionBuilderImplementor

Specified by:

clearEventListeners in interface SharedSessionBuilder

Returns:

this, for method chaining

jdbcTimeZone

SharedSessionBuilderImplementor jdbcTimeZone(TimeZone timeZone)

Description copied from interface: SessionBuilder

Specify the JDBC time zone for the session.

Specified by:

jdbcTimeZone in interface CommonBuilder

Specified by:

jdbcTimeZone in interface CommonSharedBuilder

Specified by:

jdbcTimeZone in interface SessionBuilder

Specified by:

jdbcTimeZone in interface SessionBuilderImplementor

Specified by:

jdbcTimeZone in interface SharedSessionBuilder

Returns:

this, for method chaining

connection

SharedSessionBuilderImplementor connection(Connection connection)

Description copied from interface: SessionBuilder

Adds a specific connection to the session options.

Specified by:

connection in interface CommonBuilder

Specified by:

connection in interface CommonSharedBuilder

Specified by:

connection in interface SessionBuilder

Specified by:

connection in interface SessionBuilderImplementor

Specified by:

connection in interface SharedSessionBuilder

Parameters:

connection - The connection to use.

Returns:

this, for method chaining

autoJoinTransactions

SharedSessionBuilderImplementor autoJoinTransactions(boolean autoJoinTransactions)

Description copied from interface: SessionBuilder

Should the session built automatically join in any ongoing JTA transactions.

Specified by:

autoJoinTransactions in interface SessionBuilder

Specified by:

autoJoinTransactions in interface SessionBuilderImplementor

Specified by:

autoJoinTransactions in interface SharedSessionBuilder

Parameters:

autoJoinTransactions - Should JTA transactions be automatically joined

Returns:

this, for method chaining

See Also:

• SynchronizationType.SYNCHRONIZED

autoClose

SharedSessionBuilderImplementor autoClose(boolean autoClose)

Description copied from interface: SessionBuilder

Should the session be automatically closed after transaction completion?

Specified by:

autoClose in interface SessionBuilder

Specified by:

autoClose in interface SessionBuilderImplementor

Specified by:

autoClose in interface SharedSessionBuilder

Parameters:

autoClose - Should the session be automatically closed

Returns:

this, for method chaining

See Also:

• PersistenceContextType

identifierRollback

SharedSessionBuilderImplementor identifierRollback(boolean identifierRollback)

Description copied from interface: SessionBuilder

Enable identifier rollback after entity removal for the session.

Specified by:

identifierRollback in interface SessionBuilder

Specified by:

identifierRollback in interface SessionBuilderImplementor

Specified by:

identifierRollback in interface SharedSessionBuilder

Returns:

this, for method chaining

See Also:

• AvailableSettings.USE_IDENTIFIER_ROLLBACK

statementInspector

SharedSessionBuilderImplementor statementInspector()

Description copied from interface: CommonSharedBuilder

Signifies that the SQL statement inspector from the original session should be used.

Specified by:

statementInspector in interface CommonSharedBuilder

Specified by:

statementInspector in interface SharedSessionBuilder

noStatementInspector

SharedSessionBuilderImplementor noStatementInspector()

Description copied from interface: CommonBuilder

Signifies that no SQL statement inspector should be used.

By default, if no inspector is explicitly specified, the inspector associated with the SessionFactory is inherited by the new session.

Calling CommonBuilder.interceptor(Interceptor) with null has the same effect.

Specified by:

noStatementInspector in interface CommonBuilder

Specified by:

noStatementInspector in interface CommonSharedBuilder

Specified by:

noStatementInspector in interface SessionBuilder

Specified by:

noStatementInspector in interface SessionBuilderImplementor

Specified by:

noStatementInspector in interface SharedSessionBuilder

Returns:

this, for method chaining

defaultBatchFetchSize

SharedSessionBuilderImplementor defaultBatchFetchSize(int defaultBatchFetchSize)

Description copied from interface: SessionBuilder

Specify the default batch fetch size for the session.

Specified by:

defaultBatchFetchSize in interface SessionBuilder

Specified by:

defaultBatchFetchSize in interface SessionBuilderImplementor

Specified by:

defaultBatchFetchSize in interface SharedSessionBuilder

Returns:

this, for method chaining

See Also:

• FetchSettings.DEFAULT_BATCH_FETCH_SIZE
• Session.setFetchBatchSize(int)

subselectFetchEnabled

SharedSessionBuilderImplementor subselectFetchEnabled(boolean subselectFetchEnabled)

Description copied from interface: SessionBuilder

Specify whether subselect fetching is enabled for the session.

Specified by:

subselectFetchEnabled in interface SessionBuilder

Specified by:

subselectFetchEnabled in interface SessionBuilderImplementor

Specified by:

subselectFetchEnabled in interface SharedSessionBuilder

Returns:

this, for method chaining

See Also:

• FetchSettings.USE_SUBSELECT_FETCH
• Session.setSubselectFetchingEnabled(boolean)