Package org.hibernate

Interface SharedSessionContract

All Superinterfaces:

AutoCloseable, Closeable, QueryProducer, Serializable

All Known Subinterfaces:

EventSource, Session, SessionImplementor, SharedSessionContractImplementor, StatelessSession

All Known Implementing Classes:

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

public interface SharedSessionContract
extends QueryProducer, Closeable, Serializable

Declares operations that are common between Session and StatelessSession.

Method Summary

Modifier and Type	Method	Description
Transaction	beginTransaction()	Begin a unit of work and return the associated Transaction object.
void	close()	End the session by releasing the JDBC connection and cleaning up.
ProcedureCall	createNamedStoredProcedureQuery(String name)	Obtain a ProcedureCall based on a named template
ProcedureCall	createStoredProcedureCall(String procedureName)	Create a ProcedureCall to a stored procedure.
ProcedureCall	createStoredProcedureCall(String procedureName, Class<?>... resultClasses)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureCall(String procedureName, String... resultSetMappings)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureQuery(String procedureName)	Create a ProcedureCall to a stored procedure.
ProcedureCall	createStoredProcedureQuery(String procedureName, Class<?>... resultClasses)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureQuery(String procedureName, String... resultSetMappings)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
default <T> T	doReturningWork(ReturningWork<T> work)	Perform work using the Connection underlying by this session, and return a result.
default void	doWork(Work work)	Perform work using the Connection underlying by this session.
HibernateCriteriaBuilder	getCriteriaBuilder()	Obtain a HibernateCriteriaBuilder which may be used to construct criteria queries.
Integer	getJdbcBatchSize()	Get the session-level JDBC batch size for the current session.
ProcedureCall	getNamedProcedureCall(String name)	Obtain a ProcedureCall based on a named template
String	getTenantIdentifier()	Obtain the tenant identifier associated with this session.
Transaction	getTransaction()	Get the Transaction instance associated with this session.
boolean	isConnected()	Check if the session is currently connected.
boolean	isJoinedToTransaction()	Check if the session is joined to the current transaction.
boolean	isOpen()	Check if the session is still open.
void	joinTransaction()	Join the currently-active JTA transaction.
void	setJdbcBatchSize(Integer jdbcBatchSize)	Set the session-level JDBC batch size.

Methods inherited from interface org.hibernate.query.QueryProducer

createMutationQuery, createMutationQuery, createMutationQuery, createMutationQuery, createNamedMutationQuery, createNamedQuery, createNamedQuery, createNamedSelectionQuery, createNamedSelectionQuery, createNativeMutationQuery, createNativeQuery, createNativeQuery, createNativeQuery, createNativeQuery, createNativeQuery, createQuery, createQuery, createQuery, createQuery, createQuery, createSelectionQuery, createSelectionQuery, createSelectionQuery, getNamedNativeQuery, getNamedNativeQuery, getNamedQuery

Method Detail

getTenantIdentifier

String getTenantIdentifier()

Obtain the tenant identifier associated with this session.

Returns:

The tenant identifier associated with this session, or null

close

void close()
    throws HibernateException

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

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

HibernateException - Indicates problems cleaning up.

isOpen

boolean isOpen()

Check if the session is still open.

Returns:

boolean

isConnected

boolean isConnected()

Check if the session is currently connected.

Returns:

boolean

beginTransaction

Transaction beginTransaction()

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

Returns:

a Transaction instance

See Also:

getTransaction()

getTransaction

Transaction getTransaction()

Get the Transaction instance associated with this session.

Returns:

a Transaction instance

See Also:

EntityManager.getTransaction()

joinTransaction

void joinTransaction()

Join the currently-active JTA transaction.

Since:

6.2

See Also:

EntityManager.joinTransaction()

isJoinedToTransaction

boolean isJoinedToTransaction()

Check if the session is joined to the current transaction.

Since:

6.2

See Also:

joinTransaction(), EntityManager.isJoinedToTransaction()

getNamedProcedureCall

ProcedureCall getNamedProcedureCall(String name)

Obtain a ProcedureCall based on a named template

Parameters:

name - The name given to the template

Returns:

The ProcedureCall

See Also:

NamedStoredProcedureQuery

createStoredProcedureCall

ProcedureCall createStoredProcedureCall(String procedureName)

Create a ProcedureCall to a stored procedure.

Parameters:

procedureName - The name of the procedure.

Returns:

The representation of the procedure call.

createStoredProcedureCall

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

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

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

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

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

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.

createNamedStoredProcedureQuery

ProcedureCall createNamedStoredProcedureQuery(String name)

Obtain a ProcedureCall based on a named template

Parameters:

name - The name given to the template

Returns:

The ProcedureCall

See Also:

NamedStoredProcedureQuery

createStoredProcedureQuery

ProcedureCall createStoredProcedureQuery(String procedureName)

Create a ProcedureCall to a stored procedure.

Parameters:

procedureName - The name of the procedure.

Returns:

The representation of the procedure call.

createStoredProcedureQuery

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

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

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

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

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

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.

getJdbcBatchSize

Integer getJdbcBatchSize()

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

Returns:

the current session-level JDBC batch size

Since:

5.2

See Also:

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

setJdbcBatchSize

void setJdbcBatchSize(Integer jdbcBatchSize)

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

Parameters:

jdbcBatchSize - the new session-level JDBC batch size

Since:

5.2

See Also:

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

getCriteriaBuilder

HibernateCriteriaBuilder getCriteriaBuilder()

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

Returns:

an instance of HibernateCriteriaBuilder

Throws:

IllegalStateException - if the session has been closed

See Also:

SessionFactory.getCriteriaBuilder()

doWork

default void doWork(Work work)
             throws HibernateException

Perform work using the Connection underlying by this session.

Parameters:

work - The work to be performed.

Throws:

HibernateException - Generally indicates wrapped SQLException

doReturningWork

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

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

Type Parameters:

T - The type of the result returned from the work

Parameters:

work - The work to be performed.

Returns:

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

Throws:

HibernateException - Generally indicates wrapped SQLException