Class StatelessSessionLazyDelegator

java.lang.Object

org.hibernate.engine.spi.StatelessSessionLazyDelegator

All Implemented Interfaces:

Serializable, AutoCloseable, QueryProducer, SharedSessionContract, StatelessSession

public abstract class StatelessSessionLazyDelegator
extends Object
implements StatelessSession

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
StatelessSessionLazyDelegator()

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.
<T> RootGraph<T>	createEntityGraph(Class<T> rootType)	Create a new mutable instance of EntityGraph, with only a root node, allowing programmatic definition of the graph from scratch.
<T> RootGraph<T>	createEntityGraph(Class<T> rootType, String graphName)	Create a new mutable instance of EntityGraph, based on a predefined named entity graph, allowing customization of the graph, or return null if there is no predefined graph with the given name.
RootGraph<?>	createEntityGraph(String graphName)	Create a new mutable instance of EntityGraph, based on a predefined named entity graph, allowing customization of the graph, or return null if there is no predefined graph with the given name.
MutationQuery	createMutationQuery(CriteriaDelete deleteQuery)	Create a MutationQuery from the given delete criteria tree
MutationQuery	createMutationQuery(CriteriaUpdate updateQuery)	Create a MutationQuery from the given update criteria tree
MutationQuery	createMutationQuery(String hqlString)	Create a MutationQuery reference for the given HQL insert, update, or delete statement.
MutationQuery	createMutationQuery(JpaCriteriaInsert insert)	Create a MutationQuery from the given insert criteria tree
MutationQuery	createNamedMutationQuery(String name)	Create a MutationQuery instance for the given named insert, update, or delete HQL query.
Query	createNamedQuery(String name)	Deprecated.
<R> Query<R>	createNamedQuery(String name, Class<R> resultClass)	Create a typed Query instance for the given named query.
SelectionQuery<?>	createNamedSelectionQuery(String name)	Deprecated.
<R> SelectionQuery<R>	createNamedSelectionQuery(String name, Class<R> resultType)	Create a SelectionQuery instance for the named NamedQuery with the given result type.
ProcedureCall	createNamedStoredProcedureQuery(String name)	Obtain a ProcedureCall based on a named template
MutationQuery	createNativeMutationQuery(String sqlString)	Create a NativeQuery instance for the given native SQL statement.
NativeQuery	createNativeQuery(String sqlString)	Deprecated.
<R> NativeQuery<R>	createNativeQuery(String sqlString, Class<R> resultClass)	Create a NativeQuery instance for the given native SQL query using an implicit mapping to the specified Java type.
<R> NativeQuery<R>	createNativeQuery(String sqlString, Class<R> resultClass, String tableAlias)	Create a NativeQuery instance for the given native SQL query using an implicit mapping to the specified Java entity type.
NativeQuery	createNativeQuery(String sqlString, String resultSetMappingName)	Deprecated.
<R> NativeQuery<R>	createNativeQuery(String sqlString, String resultSetMappingName, Class<R> resultClass)	Create a NativeQuery instance for the given native SQL query using an explicit mapping to the specified Java type.
Query	createQuery(CriteriaDelete deleteQuery)	Deprecated.
<R> Query<R>	createQuery(CriteriaQuery<R> criteriaQuery)	Create a Query for the given JPA CriteriaQuery.
Query	createQuery(CriteriaUpdate updateQuery)	Deprecated.
<R> Query<R>	createQuery(TypedQueryReference<R> typedQueryReference)	Create a typed Query instance for the given typed query reference.
Query	createQuery(String queryString)	Deprecated.
<R> Query<R>	createQuery(String queryString, Class<R> resultClass)	Create a typed Query instance for the given HQL query string and given query result type.
<R> SelectionQuery<R>	createSelectionQuery(CriteriaQuery<R> criteria)	Create a SelectionQuery reference for the given CriteriaQuery.
SelectionQuery<?>	createSelectionQuery(String hqlString)	Deprecated.
<R> SelectionQuery<R>	createSelectionQuery(String hqlString, EntityGraph<R> resultGraph)	Create a SelectionQuery instance for the given HQL query string and given EntityGraph, which is interpreted as a load graph.
<R> SelectionQuery<R>	createSelectionQuery(String hqlString, Class<R> resultType)	Create a SelectionQuery instance for the given HQL query string and given query result type.
ProcedureCall	createStoredProcedureCall(String procedureName)	Create a ProcedureCall to a stored procedure.
ProcedureCall	createStoredProcedureCall(String procedureName, Class<?>... resultClasses)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureCall(String procedureName, String... resultSetMappings)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureQuery(String procedureName)	Create a ProcedureCall to a stored procedure.
ProcedureCall	createStoredProcedureQuery(String procedureName, Class<?>... resultClasses)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
ProcedureCall	createStoredProcedureQuery(String procedureName, String... resultSetMappings)	Create a ProcedureCall to a stored procedure with the given result set entity mappings.
abstract StatelessSession	delegate()
void	delete(Object entity)	Delete a record.
void	delete(String entityName, Object entity)	Delete a record.
void	deleteMultiple(List<?> entities)	Delete multiple records in the same order as the entity instances representing the records occur in the given list.
void	disableFilter(String filterName)	Disable the named filter for the current session.
<T> T	doReturningWork(ReturningWork<T> work)	Perform work using the Connection underlying by this session, and return a result.
void	doWork(Work work)	Perform work using the Connection underlying by this session.
Filter	enableFilter(String filterName)	Enable the named filter for this current session.
void	fetch(Object association)	Fetch an association or collection that's configured for lazy loading.
<T> T	get(EntityGraph<T> graph, Object id)	Retrieve a record, fetching associations specified by the given EntityGraph, which is interpreted as a load graph.
<T> T	get(EntityGraph<T> graph, Object id, LockMode lockMode)	Retrieve a record, fetching associations specified by the given EntityGraph, which is interpreted as a load graph, and obtaining the specified lock mode.
<T> T	get(EntityGraph<T> graph, GraphSemantic graphSemantic, Object id)	Retrieve a record, fetching associations specified by the given EntityGraph.
<T> T	get(EntityGraph<T> graph, GraphSemantic graphSemantic, Object id, LockMode lockMode)	Retrieve a record, fetching associations specified by the given EntityGraph, and obtaining the specified lock mode.
<T> T	get(Class<T> entityClass, Object id)	Retrieve a record.
<T> T	get(Class<T> entityClass, Object id, LockMode lockMode)	Retrieve a record, obtaining the specified lock mode.
Object	get(String entityName, Object id)	Retrieve a record.
Object	get(String entityName, Object id, LockMode lockMode)	Retrieve a record, obtaining the specified lock mode.
CacheMode	getCacheMode()	Get the current cache mode for this session.
HibernateCriteriaBuilder	getCriteriaBuilder()	Obtain a HibernateCriteriaBuilder which may be used to construct criteria queries.
Filter	getEnabledFilter(String filterName)	Retrieve a currently enabled filter by name.
RootGraph<?>	getEntityGraph(String graphName)	Obtain an immutable reference to a predefined named entity graph.
<T> List<EntityGraph<? super T>>	getEntityGraphs(Class<T> entityClass)	Retrieve all named EntityGraphs with the given root entity type.
SessionFactory	getFactory()	The factory which created this session.
Object	getIdentifier(Object entity)	Return the identifier value of the given entity, which may be detached.
Integer	getJdbcBatchSize()	Get the session-level JDBC batch size for the current session.
<T> List<T>	getMultiple(EntityGraph<T> entityGraph, List<?> ids)	Retrieve multiple rows, returning instances of the root entity of the given EntityGraph with the fetched associations specified by the graph, in a list where the position of an instance in the list matches the position of its identifier in the given array, and the list contains a null value if there is no persistent instance matching a given identifier.
<T> List<T>	getMultiple(EntityGraph<T> entityGraph, GraphSemantic graphSemantic, List<?> ids)	Retrieve multiple rows, returning instances of the root entity of the given EntityGraph with the fetched associations specified by the graph, in a list where the position of an instance in the list matches the position of its identifier in the given array, and the list contains a null value if there is no persistent instance matching a given identifier.
<T> List<T>	getMultiple(Class<T> entityClass, List<?> ids)	Retrieve multiple rows, returning entity instances in a list where the position of an instance in the list matches the position of its identifier in the given array, and the list contains a null value if there is no persistent instance matching a given identifier.
<T> List<T>	getMultiple(Class<T> entityClass, List<?> ids, LockMode lockMode)	Retrieve multiple rows, obtaining the specified lock mode, and returning entity instances in a list where the position of an instance in the list matches the position of its identifier in the given array, and the list contains a null value if there is no persistent instance matching a given identifier.
NativeQuery	getNamedNativeQuery(String name)	Deprecated.
NativeQuery	getNamedNativeQuery(String name, String resultSetMapping)	Deprecated.
ProcedureCall	getNamedProcedureCall(String name)	Obtain a ProcedureCall based on a named template
Query	getNamedQuery(String queryName)	Deprecated.
String	getTenantIdentifier()	Obtain the tenant identifier associated with this session, as a string.
Object	getTenantIdentifierValue()	Obtain the tenant identifier associated with this session.
Transaction	getTransaction()	Get the Transaction instance associated with this session.
Object	insert(Object entity)	Insert a record.
Object	insert(String entityName, Object entity)	Insert a record.
void	insertMultiple(List<?> entities)	Insert multiple records in the same order as the entity instances representing the new records occur in the given list.
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	refresh(Object entity)	Refresh the entity instance state from the database.
void	refresh(Object entity, LockMode lockMode)	Refresh the entity instance state from the database.
void	refresh(String entityName, Object entity)	Refresh the entity instance state from the database.
void	refresh(String entityName, Object entity, LockMode lockMode)	Refresh the entity instance state from the database.
SharedSessionBuilder	sessionWithOptions()	Obtain a Session builder with the ability to copy certain information from this session.
void	setCacheMode(CacheMode cacheMode)	Set the current cache mode for this session.
void	setJdbcBatchSize(Integer jdbcBatchSize)	Set the session-level JDBC batch size.
SharedStatelessSessionBuilder	statelessWithOptions()	Obtain a StatelessSession builder with the ability to copy certain information from this session.
<T> T	unwrap(Class<T> type)	Return an object of the specified type to allow access to a provider-specific API.
void	update(Object entity)	Update a record.
void	update(String entityName, Object entity)	Update a record.
void	updateMultiple(List<?> entities)	Update multiple records in the same order as the entity instances representing the records occur in the given list.
void	upsert(Object entity)	Use a SQL merge into statement to perform an upsert, that is, to insert the record if it does not exist, or update it if it already exists.
void	upsert(String entityName, Object entity)	Use a SQL merge into statement to perform an upsert.
void	upsertMultiple(List<?> entities)	Upsert multiple records, that is, for a given record, insert the record if it does not exist or update the record if it already exists, in the same order as the entity instances representing the records occur in the given list.

Methods inherited from class Object

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

Methods inherited from interface SharedSessionContract

fromTransaction, inTransaction

Constructor Details

StatelessSessionLazyDelegator

public StatelessSessionLazyDelegator()

Method Details

delegate

public abstract StatelessSession delegate()

delete

public void delete(Object entity)

Description copied from interface: StatelessSession

Delete a record.

The PostRemove callback will be triggered if the operation is successful.

Specified by:

delete in interface StatelessSession

Parameters:

entity - a detached entity instance

insert

public Object insert(Object entity)

Description copied from interface: StatelessSession

Insert a record.

If the entity @Id field is declared to be generated, for example, if it is annotated @GeneratedValue, the id is generated and assigned to the given instance.

The PostPersist callback will be triggered if the operation is successful.

Specified by:

insert in interface StatelessSession

Parameters:

entity - a new transient instance

Returns:

The identifier of the inserted entity

insertMultiple

public void insertMultiple(List<?> entities)

Description copied from interface: StatelessSession

Insert multiple records in the same order as the entity instances representing the new records occur in the given list.

Specified by:

insertMultiple in interface StatelessSession

Parameters:

entities - a list of transient instances to be inserted

insert

public Object insert(String entityName,
 Object entity)

Description copied from interface: StatelessSession

Insert a record.

The PostPersist callback will be triggered if the operation is successful.

Specified by:

insert in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be inserted

entity - a new transient instance

Returns:

the identifier of the instance

update

public void update(Object entity)

Description copied from interface: StatelessSession

Update a record.

The PostUpdate callback will be triggered if the operation is successful.

Specified by:

update in interface StatelessSession

Parameters:

entity - a detached entity instance

updateMultiple

public void updateMultiple(List<?> entities)

Description copied from interface: StatelessSession

Update multiple records in the same order as the entity instances representing the records occur in the given list.

Specified by:

updateMultiple in interface StatelessSession

Parameters:

entities - a list of detached instances to be updated

update

public void update(String entityName,
 Object entity)

Description copied from interface: StatelessSession

Update a record.

The PostUpdate callback will be triggered if the operation is successful.

Specified by:

update in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be updated

entity - a detached entity instance

deleteMultiple

public void deleteMultiple(List<?> entities)

Description copied from interface: StatelessSession

Delete multiple records in the same order as the entity instances representing the records occur in the given list.

Specified by:

deleteMultiple in interface StatelessSession

Parameters:

entities - a list of detached instances to be deleted

delete

public void delete(String entityName,
 Object entity)

Description copied from interface: StatelessSession

Delete a record.

The PostRemove callback will be triggered if the operation is successful.

Specified by:

delete in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be deleted

entity - a detached entity instance

upsert

public void upsert(Object entity)

Description copied from interface: StatelessSession

Use a SQL merge into statement to perform an upsert, that is, to insert the record if it does not exist, or update it if it already exists.

This method never performs id generation, and does not accept an entity instance with a null identifier. When id generation is required, use StatelessSession.insert(Object).

On the other hand, upsert() does accept an entity instance with an assigned identifier value, even if the entity @Id field is declared to be generated, for example, if it is annotated @GeneratedValue. Thus, this method may be used to import data from an external source.

Specified by:

upsert in interface StatelessSession

Parameters:

entity - a detached entity instance, or a new instance with an assigned identifier

upsertMultiple

public void upsertMultiple(List<?> entities)

Description copied from interface: StatelessSession

Upsert multiple records, that is, for a given record, insert the record if it does not exist or update the record if it already exists, in the same order as the entity instances representing the records occur in the given list.

Specified by:

upsertMultiple in interface StatelessSession

Parameters:

entities - a list of detached instances and new instances with assigned identifiers

upsert

public void upsert(String entityName,
 Object entity)

Description copied from interface: StatelessSession

Use a SQL merge into statement to perform an upsert.

Specified by:

upsert in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be merged

entity - a detached entity instance

get

public Object get(String entityName,
 Object id)

Description copied from interface: StatelessSession

Retrieve a record.

Specified by:

get in interface StatelessSession

Parameters:

entityName - The name of the entity to retrieve

id - The id of the entity to retrieve

Returns:

a detached entity instance, or null if there is no instance with the given id

get

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

Description copied from interface: StatelessSession

Retrieve a record.

Specified by:

get in interface StatelessSession

Parameters:

entityClass - The class of the entity to retrieve

id - The id of the entity to retrieve

Returns:

a detached entity instance, or null if there is no instance with the given id

get

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

Description copied from interface: StatelessSession

Retrieve a record, obtaining the specified lock mode.

Specified by:

get in interface StatelessSession

Parameters:

entityName - The name of the entity to retrieve

id - The id of the entity to retrieve

lockMode - The lock mode to apply to the entity

Returns:

a detached entity instance, or null if there is no instance with the given id

get

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

Description copied from interface: StatelessSession

Retrieve a record, obtaining the specified lock mode.

Specified by:

get in interface StatelessSession

Parameters:

entityClass - The class of the entity to retrieve

id - The id of the entity to retrieve

lockMode - The lock mode to apply to the entity

Returns:

a detached entity instance, or null if there is no instance with the given id

get

public <T> T get(EntityGraph<T> graph,
 Object id)

Description copied from interface: StatelessSession

Retrieve a record, fetching associations specified by the given EntityGraph, which is interpreted as a load graph.

Specified by:

get in interface StatelessSession

Parameters:

graph - The EntityGraph, interpreted as a load graph

id - The id of the entity to retrieve

Returns:

a detached entity instance, or null if there is no instance with the given id

get

public <T> T get(EntityGraph<T> graph,
 Object id,
 LockMode lockMode)

Description copied from interface: StatelessSession

Retrieve a record, fetching associations specified by the given EntityGraph, which is interpreted as a load graph, and obtaining the specified lock mode.

Specified by:

get in interface StatelessSession

Parameters:

graph - The EntityGraph, interpreted as a load graph

id - The id of the entity to retrieve

lockMode - The lock mode to apply to the entity

Returns:

a detached entity instance, or null if there is no instance with the given id

get

public <T> T get(EntityGraph<T> graph,
 GraphSemantic graphSemantic,
 Object id)

Description copied from interface: StatelessSession

Retrieve a record, fetching associations specified by the given EntityGraph.

Specified by:

get in interface StatelessSession

Parameters:

graph - The EntityGraph

graphSemantic - a GraphSemantic specifying how the graph should be interpreted

id - The id of the entity to retrieve

Returns:

a detached entity instance, or null if there is no instance with the given id

get

public <T> T get(EntityGraph<T> graph,
 GraphSemantic graphSemantic,
 Object id,
 LockMode lockMode)

Description copied from interface: StatelessSession

Retrieve a record, fetching associations specified by the given EntityGraph, and obtaining the specified lock mode.

Specified by:

get in interface StatelessSession

Parameters:

graph - The EntityGraph

graphSemantic - a GraphSemantic specifying how the graph should be interpreted

id - The id of the entity to retrieve

lockMode - The lock mode to apply to the entity

Returns:

a detached entity instance, or null if there is no instance with the given id

getMultiple

public <T> List<T> getMultiple(Class<T> entityClass,
 List<?> ids)

Description copied from interface: StatelessSession

Retrieve multiple rows, returning entity instances in a list where the position of an instance in the list matches the position of its identifier in the given array, and the list contains a null value if there is no persistent instance matching a given identifier.

Specified by:

getMultiple in interface StatelessSession

Parameters:

entityClass - The class of the entity to retrieve

ids - The ids of the entities to retrieve

Returns:

an ordered list of detached entity instances, with null elements representing missing entities

getMultiple

public <T> List<T> getMultiple(Class<T> entityClass,
 List<?> ids,
 LockMode lockMode)

Description copied from interface: StatelessSession

Retrieve multiple rows, obtaining the specified lock mode, and returning entity instances in a list where the position of an instance in the list matches the position of its identifier in the given array, and the list contains a null value if there is no persistent instance matching a given identifier.

Specified by:

getMultiple in interface StatelessSession

Parameters:

entityClass - The class of the entity to retrieve

ids - The ids of the entities to retrieve

lockMode - The lock mode to apply to the entities

Returns:

an ordered list of detached entity instances, with null elements representing missing entities

getMultiple

public <T> List<T> getMultiple(EntityGraph<T> entityGraph,
 List<?> ids)

Description copied from interface: StatelessSession

Retrieve multiple rows, returning instances of the root entity of the given EntityGraph with the fetched associations specified by the graph, in a list where the position of an instance in the list matches the position of its identifier in the given array, and the list contains a null value if there is no persistent instance matching a given identifier.

Specified by:

getMultiple in interface StatelessSession

Parameters:

entityGraph - The EntityGraph, interpreted as a load graph

ids - The ids of the entities to retrieve

Returns:

an ordered list of detached entity instances, with null elements representing missing entities

getMultiple

public <T> List<T> getMultiple(EntityGraph<T> entityGraph,
 GraphSemantic graphSemantic,
 List<?> ids)

Description copied from interface: StatelessSession

Retrieve multiple rows, returning instances of the root entity of the given EntityGraph with the fetched associations specified by the graph, in a list where the position of an instance in the list matches the position of its identifier in the given array, and the list contains a null value if there is no persistent instance matching a given identifier.

Specified by:

getMultiple in interface StatelessSession

Parameters:

entityGraph - The EntityGraph

graphSemantic - a GraphSemantic specifying how the graph should be interpreted

ids - The ids of the entities to retrieve

Returns:

an ordered list of detached entity instances, with null elements representing missing entities

refresh

public void refresh(Object entity)

Description copied from interface: StatelessSession

Refresh the entity instance state from the database.

Specified by:

refresh in interface StatelessSession

Parameters:

entity - The entity to be refreshed.

refresh

public void refresh(String entityName,
 Object entity)

Description copied from interface: StatelessSession

Refresh the entity instance state from the database.

Specified by:

refresh in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be refreshed.

entity - The entity to be refreshed.

refresh

public void refresh(Object entity,
 LockMode lockMode)

Description copied from interface: StatelessSession

Refresh the entity instance state from the database.

Specified by:

refresh in interface StatelessSession

Parameters:

entity - The entity to be refreshed.

lockMode - The LockMode to be applied.

refresh

public void refresh(String entityName,
 Object entity,
 LockMode lockMode)

Description copied from interface: StatelessSession

Refresh the entity instance state from the database.

Specified by:

refresh in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be refreshed.

entity - The entity to be refreshed.

lockMode - The LockMode to be applied.

fetch

public void fetch(Object association)

Description copied from interface: StatelessSession

Fetch an association or collection that's configured for lazy loading.

Book book = session.get(Book.class, isbn);  // book is immediately detached
session.fetch(book.getAuthors());           // fetch the associated authors
book.getAuthors().forEach(author -> ... );  // iterate the collection

Warning: this operation in a stateless session is quite sensitive to data aliasing effects and should be used with great care. It's usually better to fetch associations using eager join fetching.

Specified by:

fetch in interface StatelessSession

Parameters:

association - a lazy-loaded association

See Also:

• Hibernate.initialize(Object)

getIdentifier

public Object getIdentifier(Object entity)

Description copied from interface: StatelessSession

Return the identifier value of the given entity, which may be detached.

Specified by:

getIdentifier in interface StatelessSession

Parameters:

entity - a persistent instance associated with this session

Returns:

the identifier

statelessWithOptions

public SharedStatelessSessionBuilder statelessWithOptions()

Description copied from interface: SharedSessionContract

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

Specified by:

statelessWithOptions in interface SharedSessionContract

Returns:

the session builder

sessionWithOptions

public SharedSessionBuilder sessionWithOptions()

Description copied from interface: SharedSessionContract

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

Specified by:

sessionWithOptions in interface SharedSessionContract

Returns:

the session builder

getTenantIdentifier

public String getTenantIdentifier()

Description copied from interface: SharedSessionContract

Obtain the tenant identifier associated with this session, as a string.

Specified by:

getTenantIdentifier in interface SharedSessionContract

Returns:

The tenant identifier associated with this session, or null

See Also:

• CurrentTenantIdentifierResolver
• SessionBuilder.tenantIdentifier(Object)

getTenantIdentifierValue

public Object getTenantIdentifierValue()

Description copied from interface: SharedSessionContract

Obtain the tenant identifier associated with this session.

Specified by:

getTenantIdentifierValue in interface SharedSessionContract

Returns:

The tenant identifier associated with this session, or null

See Also:

• CurrentTenantIdentifierResolver
• SessionBuilder.tenantIdentifier(Object)

getCacheMode

public CacheMode getCacheMode()

Description copied from interface: SharedSessionContract

Get the current cache mode for this session.

Specified by:

getCacheMode in interface SharedSessionContract

Returns:

the current cache mode

setCacheMode

public void setCacheMode(CacheMode cacheMode)

Description copied from interface: SharedSessionContract

Set the current cache mode for this session.

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

Specified by:

setCacheMode in interface SharedSessionContract

Parameters:

cacheMode - the new cache mode

close

public void close()
           throws HibernateException

Description copied from interface: SharedSessionContract

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

Specified by:

close in interface AutoCloseable

Specified by:

close in interface SharedSessionContract

Throws:

HibernateException - Indicates problems cleaning up.

isOpen

public boolean isOpen()

Description copied from interface: SharedSessionContract

Check if the session is still open.

Specified by:

isOpen in interface SharedSessionContract

Returns:

true if it is open

isConnected

public boolean isConnected()

Description copied from interface: SharedSessionContract

Check if the session is currently connected.

Specified by:

isConnected in interface SharedSessionContract

Returns:

true if it is connected

beginTransaction

public Transaction beginTransaction()

Description copied from interface: SharedSessionContract

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

Specified by:

beginTransaction in interface SharedSessionContract

Returns:

an instance of Transaction representing the new transaction

See Also:

• SharedSessionContract.getTransaction()
• EntityTransaction.begin()

getTransaction

public Transaction getTransaction()

Description copied from interface: SharedSessionContract

Get the Transaction instance associated with this session.

Specified by:

getTransaction in interface SharedSessionContract

Returns:

an instance of Transaction representing the transaction associated with this session

See Also:

• EntityManager.getTransaction()

joinTransaction

public void joinTransaction()

Description copied from interface: SharedSessionContract

Join the currently-active JTA transaction.

Specified by:

joinTransaction in interface SharedSessionContract

See Also:

• EntityManager.joinTransaction()

isJoinedToTransaction

public boolean isJoinedToTransaction()

Description copied from interface: SharedSessionContract

Check if the session is joined to the current transaction.

Specified by:

isJoinedToTransaction in interface SharedSessionContract

See Also:

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

getNamedProcedureCall

public ProcedureCall getNamedProcedureCall(String name)

Description copied from interface: SharedSessionContract

Obtain a ProcedureCall based on a named template

Specified by:

getNamedProcedureCall in interface SharedSessionContract

Parameters:

name - The name given to the template

Returns:

The ProcedureCall

See Also:

• NamedStoredProcedureQuery

createStoredProcedureCall

public ProcedureCall createStoredProcedureCall(String procedureName)

Description copied from interface: SharedSessionContract

Create a ProcedureCall to a stored procedure.

Specified by:

createStoredProcedureCall in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

Returns:

The representation of the procedure call.

createStoredProcedureCall

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

Description copied from interface: SharedSessionContract

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

Specified by:

createStoredProcedureCall in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

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

Returns:

The representation of the procedure call.

createStoredProcedureCall

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

Description copied from interface: SharedSessionContract

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

Specified by:

createStoredProcedureCall in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

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

Returns:

The representation of the procedure call.

createNamedStoredProcedureQuery

public ProcedureCall createNamedStoredProcedureQuery(String name)

Description copied from interface: SharedSessionContract

Obtain a ProcedureCall based on a named template

Specified by:

createNamedStoredProcedureQuery in interface SharedSessionContract

Parameters:

name - The name given to the template

Returns:

The ProcedureCall

See Also:

• NamedStoredProcedureQuery

createStoredProcedureQuery

public ProcedureCall createStoredProcedureQuery(String procedureName)

Description copied from interface: SharedSessionContract

Create a ProcedureCall to a stored procedure.

Specified by:

createStoredProcedureQuery in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

Returns:

The representation of the procedure call.

createStoredProcedureQuery

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

Description copied from interface: SharedSessionContract

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

Specified by:

createStoredProcedureQuery in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

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

Returns:

The representation of the procedure call.

createStoredProcedureQuery

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

Description copied from interface: SharedSessionContract

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

Specified by:

createStoredProcedureQuery in interface SharedSessionContract

Parameters:

procedureName - The name of the procedure.

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

Returns:

The representation of the procedure call.

getJdbcBatchSize

public Integer getJdbcBatchSize()

Description copied from interface: SharedSessionContract

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

Specified by:

getJdbcBatchSize in interface SharedSessionContract

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. Override the factory-level JDBC batch size controlled by the configuration property "hibernate.jdbc.batch_size".

Specified by:

setJdbcBatchSize in interface SharedSessionContract

Parameters:

jdbcBatchSize - the new session-level JDBC batch size

See Also:

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

getCriteriaBuilder

public HibernateCriteriaBuilder getCriteriaBuilder()

Description copied from interface: SharedSessionContract

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

Specified by:

getCriteriaBuilder in interface SharedSessionContract

Returns:

an instance of HibernateCriteriaBuilder

See Also:

• SessionFactory.getCriteriaBuilder()

doWork

public void doWork(Work work)
            throws HibernateException

Description copied from interface: SharedSessionContract

Perform work using the Connection underlying by this session.

Specified by:

doWork in interface SharedSessionContract

Parameters:

work - The work to be performed.

Throws:

HibernateException - Generally indicates wrapped SQLException

doReturningWork

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

Description copied from interface: SharedSessionContract

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

Specified by:

doReturningWork in interface SharedSessionContract

Type Parameters:

T - The type of the result returned from the work

Parameters:

work - The work to be performed.

Returns:

the result of calling ReturningWork.execute(Connection).

createEntityGraph

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

Description copied from interface: SharedSessionContract

Create a new mutable instance of EntityGraph, with only a root node, allowing programmatic definition of the graph from scratch.

Specified by:

createEntityGraph in interface SharedSessionContract

Parameters:

rootType - the root entity class of the graph

See Also:

• EntityGraphs.createGraph(jakarta.persistence.metamodel.EntityType)

createEntityGraph

public RootGraph<?> createEntityGraph(String graphName)

Description copied from interface: SharedSessionContract

Create a new mutable instance of EntityGraph, based on a predefined named entity graph, allowing customization of the graph, or return null if there is no predefined graph with the given name.

Specified by:

createEntityGraph in interface SharedSessionContract

Parameters:

graphName - the name of the graph

See Also:

• EntityManagerFactory.getNamedEntityGraphs(Class)
• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)

createEntityGraph

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

Description copied from interface: SharedSessionContract

Create a new mutable instance of EntityGraph, based on a predefined named entity graph, allowing customization of the graph, or return null if there is no predefined graph with the given name.

Specified by:

createEntityGraph in interface SharedSessionContract

Parameters:

rootType - the root entity class of the graph

graphName - the name of the predefined named entity graph

See Also:

• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)
• EntityManager.createEntityGraph(String)

getEntityGraph

public RootGraph<?> getEntityGraph(String graphName)

Description copied from interface: SharedSessionContract

Obtain an immutable reference to a predefined named entity graph.

Specified by:

getEntityGraph in interface SharedSessionContract

Parameters:

graphName - the name of the predefined named entity graph

See Also:

• EntityManager.getEntityGraph(String)
• EntityManagerFactory.getNamedEntityGraphs(Class)
• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)

getEntityGraphs

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

Description copied from interface: SharedSessionContract

Retrieve all named EntityGraphs with the given root entity type.

Specified by:

getEntityGraphs in interface SharedSessionContract

See Also:

• EntityManagerFactory.getNamedEntityGraphs(Class)
• EntityManagerFactory.addNamedEntityGraph(String, EntityGraph)

enableFilter

public Filter enableFilter(String filterName)

Description copied from interface: SharedSessionContract

Enable the named filter for this current session.

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

Specified by:

enableFilter in interface SharedSessionContract

Parameters:

filterName - the name of the filter to be enabled.

Returns:

the Filter instance representing the enabled filter.

See Also:

• FilterDef

getEnabledFilter

public Filter getEnabledFilter(String filterName)

Description copied from interface: SharedSessionContract

Retrieve a currently enabled filter by name.

Specified by:

getEnabledFilter in interface SharedSessionContract

Parameters:

filterName - the name of the filter to be retrieved.

Returns:

the Filter instance representing the enabled filter.

disableFilter

public void disableFilter(String filterName)

Description copied from interface: SharedSessionContract

Disable the named filter for the current session.

Specified by:

disableFilter in interface SharedSessionContract

Parameters:

filterName - the name of the filter to be disabled.

getFactory

public SessionFactory getFactory()

Description copied from interface: SharedSessionContract

The factory which created this session.

Specified by:

getFactory in interface SharedSessionContract

createQuery

@Deprecated
public Query createQuery(String queryString)

Deprecated.

Description copied from interface: QueryProducer

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

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

• if there is exactly one root entity in the from clause, and it has no non-fetch joins, then that root entity is the only element of the select list, or
• if there is an entity with the alias this, then that entity is the only element of the select list, or
• otherwise, the query is considered ambiguous, and this method throws a SemanticException.

The query must have an explicit from clause, which can never be inferred.

Specified by:

createQuery in interface QueryProducer

Parameters:

queryString - The HQL query

Returns:

The Query instance for manipulation and execution

See Also:

• EntityManager.createQuery(String)

createQuery

public <R> Query<R> createQuery(String queryString,
 Class<R> resultClass)

Description copied from interface: QueryProducer

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

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

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

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

If a query has no explicit from clause, and the given result type is an entity type, the root entity is inferred to be the result type.

Passing Object.class as the query result type is not recommended. In this special case, this method has the same semantics as the overload QueryProducer.createQuery(String).

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

Specified by:

createQuery in interface QueryProducer

Parameters:

queryString - The HQL query

resultClass - The Class object representing the query result type, which should not be Object.class

Returns:

The Query instance for manipulation and execution

See Also:

• EntityManager.createQuery(String,Class)

createQuery

public <R> Query<R> createQuery(TypedQueryReference<R> typedQueryReference)

Description copied from interface: QueryProducer

Create a typed Query instance for the given typed query reference.

Specified by:

createQuery in interface QueryProducer

Parameters:

typedQueryReference - the type query reference

Returns:

The Query instance for execution

See Also:

• EntityManager.createQuery(TypedQueryReference)

createQuery

public <R> Query<R> createQuery(CriteriaQuery<R> criteriaQuery)

Description copied from interface: QueryProducer

Create a Query for the given JPA CriteriaQuery.

Specified by:

createQuery in interface QueryProducer

createQuery

@Deprecated
public Query createQuery(CriteriaUpdate updateQuery)

Deprecated.

Description copied from interface: QueryProducer

Create a MutationQuery for the given JPA CriteriaUpdate

Specified by:

createQuery in interface QueryProducer

createQuery

@Deprecated
public Query createQuery(CriteriaDelete deleteQuery)

Deprecated.

Description copied from interface: QueryProducer

Create a MutationQuery for the given JPA CriteriaDelete

Specified by:

createQuery in interface QueryProducer

createNativeQuery

@Deprecated
public NativeQuery createNativeQuery(String sqlString)

Deprecated.

Description copied from interface: QueryProducer

Create a NativeQuery instance for the given native SQL query.

Specified by:

createNativeQuery in interface QueryProducer

Parameters:

sqlString - a native SQL query string

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String)

createNativeQuery

public <R> NativeQuery<R> createNativeQuery(String sqlString,
 Class<R> resultClass)

Description copied from interface: QueryProducer

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

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

Specified by:

createNativeQuery in interface QueryProducer

Parameters:

sqlString - The native (SQL) query string

resultClass - The Java type to map results to

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String,Class)

createNativeQuery

public <R> NativeQuery<R> createNativeQuery(String sqlString,
 Class<R> resultClass,
 String tableAlias)

Description copied from interface: QueryProducer

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

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

Specified by:

createNativeQuery in interface QueryProducer

Parameters:

sqlString - Native (SQL) query string

resultClass - The Java entity class to map results to

tableAlias - The table alias for columns in the result set

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String,Class)

createNativeQuery

@Deprecated
public NativeQuery createNativeQuery(String sqlString,
 String resultSetMappingName)

Deprecated.

Description copied from interface: QueryProducer

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

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

Specified by:

createNativeQuery in interface QueryProducer

Parameters:

sqlString - The native (SQL) query string

resultSetMappingName - The explicit result mapping name

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String,Class)
• SqlResultSetMapping

createNativeQuery

public <R> NativeQuery<R> createNativeQuery(String sqlString,
 String resultSetMappingName,
 Class<R> resultClass)

Description copied from interface: QueryProducer

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

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

Specified by:

createNativeQuery in interface QueryProducer

Parameters:

sqlString - The native (SQL) query string

resultSetMappingName - The explicit result mapping name

Returns:

The NativeQuery instance for manipulation and execution

See Also:

• EntityManager.createNativeQuery(String,Class)
• SqlResultSetMapping

createSelectionQuery

@Deprecated
public SelectionQuery<?> createSelectionQuery(String hqlString)

Deprecated.

Description copied from interface: QueryProducer

Create a SelectionQuery reference for the given HQL select statement.

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

• if there is exactly one root entity in the from clause, and it has no non-fetch joins, then that root entity is the only element of the select list, or
• if there is an entity with the alias this, then that entity is the only element of the select list, or
• otherwise, the query is considered ambiguous, and this method throws a SemanticException.

The query must have an explicit from clause, which can never be inferred.

Specified by:

createSelectionQuery in interface QueryProducer

createSelectionQuery

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

Description copied from interface: QueryProducer

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

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

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

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

If a query has no explicit from clause, and the given result type is an entity type, the root entity is inferred to be the result type.

Passing Object.class as the query result type is not recommended. In this special case, this method has the same semantics as the overload QueryProducer.createSelectionQuery(String).

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

Specified by:

createSelectionQuery in interface QueryProducer

Parameters:

hqlString - The HQL select query as a string

resultType - The Class object representing the query result type, which should not be Object.class

See Also:

• EntityManager.createQuery(String)

createSelectionQuery

public <R> SelectionQuery<R> createSelectionQuery(String hqlString,
 EntityGraph<R> resultGraph)

Description copied from interface: QueryProducer

Create a SelectionQuery instance for the given HQL query string and given EntityGraph, which is interpreted as a load graph. The query result type is the root entity of the given graph.

• If the query has an explicit select clause, there must be a single item in the select list, and the select item must be assignable to the root type of the given graph.
• Otherwise, if a query has no explicit select list, the select list is inferred from the given entity graph. The query must have exactly one root entity in the from clause, it must be assignable to the root type of the given graph, and the inferred select list will contain just that entity.

If a query has no explicit from clause, and the given result type is an entity type, the root entity is inferred to be the result type.

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

Specified by:

createSelectionQuery in interface QueryProducer

Parameters:

hqlString - The HQL select query as a string

resultGraph - An EntityGraph whose root type is the query result type, which is interpreted as a load graph

See Also:

• EntityManager.createQuery(String)

createSelectionQuery

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

Description copied from interface: QueryProducer

Create a SelectionQuery reference for the given CriteriaQuery.

Specified by:

createSelectionQuery in interface QueryProducer

See Also:

• EntityManager.createQuery(CriteriaQuery)

createMutationQuery

public MutationQuery createMutationQuery(String hqlString)

Description copied from interface: QueryProducer

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

Specified by:

createMutationQuery in interface QueryProducer

Parameters:

hqlString - The HQL insert, update, or delete statement

createMutationQuery

public MutationQuery createMutationQuery(CriteriaUpdate updateQuery)

Description copied from interface: QueryProducer

Create a MutationQuery from the given update criteria tree

Specified by:

createMutationQuery in interface QueryProducer

createMutationQuery

public MutationQuery createMutationQuery(CriteriaDelete deleteQuery)

Description copied from interface: QueryProducer

Create a MutationQuery from the given delete criteria tree

Specified by:

createMutationQuery in interface QueryProducer

createMutationQuery

public MutationQuery createMutationQuery(JpaCriteriaInsert insert)

Description copied from interface: QueryProducer

Create a MutationQuery from the given insert criteria tree

Specified by:

createMutationQuery in interface QueryProducer

createNativeMutationQuery

public MutationQuery createNativeMutationQuery(String sqlString)

Description copied from interface: QueryProducer

Create a NativeQuery instance for the given native SQL statement.

Specified by:

createNativeMutationQuery in interface QueryProducer

Parameters:

sqlString - a native SQL statement string

Returns:

The NativeQuery instance for manipulation and execution

createNamedQuery

@Deprecated
public Query createNamedQuery(String name)

Deprecated.

Description copied from interface: QueryProducer

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

Specified by:

createNamedQuery in interface QueryProducer

Parameters:

name - the name of a predefined named query

Returns:

The Query instance for manipulation and execution

See Also:

• EntityManager.createNamedQuery(String)

createNamedQuery

public <R> Query<R> createNamedQuery(String name,
 Class<R> resultClass)

Description copied from interface: QueryProducer

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

Specified by:

createNamedQuery in interface QueryProducer

Parameters:

name - the name of a query defined in metadata

resultClass - the type of the query result

Returns:

The Query instance for manipulation and execution

See Also:

• EntityManager.createNamedQuery(String,Class)

createNamedSelectionQuery

@Deprecated
public SelectionQuery<?> createNamedSelectionQuery(String name)

Deprecated.

Description copied from interface: QueryProducer

Create a SelectionQuery instance for the named NamedQuery.

Specified by:

createNamedSelectionQuery in interface QueryProducer

createNamedSelectionQuery

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

Description copied from interface: QueryProducer

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

Specified by:

createNamedSelectionQuery in interface QueryProducer

createNamedMutationQuery

public MutationQuery createNamedMutationQuery(String name)

Description copied from interface: QueryProducer

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

Specified by:

createNamedMutationQuery in interface QueryProducer

getNamedQuery

@Deprecated
public Query getNamedQuery(String queryName)

Deprecated.

Description copied from interface: QueryProducer

Create a Query instance for the named query.

Specified by:

getNamedQuery in interface QueryProducer

Parameters:

queryName - the name of a predefined named query

Returns:

The Query instance for manipulation and execution

getNamedNativeQuery

@Deprecated
public NativeQuery getNamedNativeQuery(String name)

Deprecated.

Description copied from interface: QueryProducer

Get a NativeQuery instance for a named native SQL query

Specified by:

getNamedNativeQuery in interface QueryProducer

Parameters:

name - The name of the predefined query

Returns:

The NativeQuery instance for manipulation and execution

getNamedNativeQuery

@Deprecated
public NativeQuery getNamedNativeQuery(String name,
 String resultSetMapping)

Deprecated.

Description copied from interface: QueryProducer

Get a NativeQuery instance for a named native SQL query

Specified by:

getNamedNativeQuery in interface QueryProducer

Parameters:

name - The name of the predefined query

Returns:

The NativeQuery instance for manipulation and execution

unwrap

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

Description copied from interface: SharedSessionContract

Return an object of the specified type to allow access to a provider-specific API.

Specified by:

unwrap in interface SharedSessionContract

Parameters:

type - the class of the object to be returned. This is usually either the underlying class implementing SharedSessionContract or an interface it implements.

Returns:

an instance of the specified class