Interface HibernateOperations
- All Known Implementing Classes:
HibernateTemplate
execute(org.springframework.orm.hibernate5.HibernateCallback<T>)
method for Session-based lambda expressions.
Implemented by HibernateTemplate
. Not often used, but a useful option
to enhance testability, as it can easily be mocked or stubbed.
Defines HibernateTemplate
's data access methods that mirror various
Session
methods. Users are strongly encouraged to read the
Hibernate Session
javadocs for details on the semantics of those methods.
A deprecation note: While HibernateTemplate
and this operations
interface are being kept around for backwards compatibility in terms of the data
access implementation style in Spring applications, we strongly recommend the use
of native Session
access code for non-trivial interactions.
This in particular affects parameterized queries where - on Java 8+ - a custom
HibernateCallback
lambda code block with createQuery
and several
setParameter
calls on the Query
interface
is an elegant solution, to be executed via the general execute(org.springframework.orm.hibernate5.HibernateCallback<T>)
method.
All such operations which benefit from a lambda variant have been marked as
deprecated
on this interface.
A Hibernate compatibility note: HibernateTemplate
and the
operations on this interface generally aim to be applicable across all Hibernate
versions. In terms of binary compatibility, Spring ships a variant for each major
generation of Hibernate (in the present case: Hibernate ORM 5.x). However, due to
refactorings and removals in Hibernate ORM 5.3, some variants - in particular
legacy positional parameters starting from index 0 - do not work anymore.
All affected operations are marked as deprecated; please replace them with the
general execute(org.springframework.orm.hibernate5.HibernateCallback<T>)
method and custom lambda blocks creating the queries,
ideally setting named parameters through Query
.
Please be aware that deprecated operations are known to work with Hibernate
ORM 5.2 but may not work with Hibernate ORM 5.3 and higher anymore.
- Since:
- 4.2
- Author:
- Juergen Hoeller
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionint
bulkUpdate
(String queryString, Object... values) Deprecated.void
clear()
Remove all objects from theSession
cache, and cancel all pending saves, updates and deletes.void
closeIterator
(Iterator<?> it) Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodboolean
Check whether the given object is in the Session cache.void
Delete the given persistent instance.void
Delete the given persistent instance.void
Delete the given persistent instance.void
Delete the given persistent instance.void
deleteAll
(Collection<?> entities) Delete all given persistent instances.enableFilter
(String filterName) Return an enabled HibernateFilter
for the given filter name.void
Remove the given object from theSession
cache.<T> T
execute
(HibernateCallback<T> action) Execute the action specified by the given action object within aSession
.List<?>
Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodList<?>
findByCriteria
(DetachedCriteria criteria) Execute a query based on a given Hibernate criteria object.List<?>
findByCriteria
(DetachedCriteria criteria, int firstResult, int maxResults) Execute a query based on the given Hibernate criteria object.<T> List<T>
findByExample
(String entityName, T exampleEntity) Execute a query based on the given example entity object.<T> List<T>
findByExample
(String entityName, T exampleEntity, int firstResult, int maxResults) Execute a query based on a given example entity object.<T> List<T>
findByExample
(T exampleEntity) Execute a query based on the given example entity object.<T> List<T>
findByExample
(T exampleEntity, int firstResult, int maxResults) Execute a query based on a given example entity object.List<?>
findByNamedParam
(String queryString, String[] paramNames, Object[] values) Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodList<?>
findByNamedParam
(String queryString, String paramName, Object value) Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodList<?>
findByNamedQuery
(String queryName, Object... values) Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodList<?>
findByNamedQueryAndNamedParam
(String queryName, String[] paramNames, Object[] values) Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodList<?>
findByNamedQueryAndNamedParam
(String queryName, String paramName, Object value) Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodList<?>
findByNamedQueryAndValueBean
(String queryName, Object valueBean) Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodList<?>
findByValueBean
(String queryString, Object valueBean) Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodvoid
flush()
Flush all pending saves, updates and deletes to the database.<T> T
get
(Class<T> entityClass, Serializable id) Return the persistent instance of the given entity class with the given identifier, ornull
if not found.<T> T
get
(Class<T> entityClass, Serializable id, LockMode lockMode) Return the persistent instance of the given entity class with the given identifier, ornull
if not found.get
(String entityName, Serializable id) Return the persistent instance of the given entity class with the given identifier, ornull
if not found.get
(String entityName, Serializable id, LockMode lockMode) Return the persistent instance of the given entity class with the given identifier, ornull
if not found.void
initialize
(Object proxy) Force initialization of a Hibernate proxy or persistent collection.Iterator<?>
Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
method<T> T
load
(Class<T> entityClass, Serializable id) Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.<T> T
load
(Class<T> entityClass, Serializable id, LockMode lockMode) Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.void
load
(Object entity, Serializable id) Load the persistent instance with the given identifier into the given object, throwing an exception if not found.load
(String entityName, Serializable id) Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.load
(String entityName, Serializable id, LockMode lockMode) Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.<T> List<T>
Return all persistent instances of the given entity class.void
Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.void
Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.<T> T
Copy the state of the given object onto the persistent object with the same identifier.<T> T
merge
(T entity) Copy the state of the given object onto the persistent object with the same identifier.void
Persist the given transient instance.void
Persist the given transient instance.void
Re-read the state of the given persistent instance.void
Re-read the state of the given persistent instance.void
replicate
(Object entity, ReplicationMode replicationMode) Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.void
replicate
(String entityName, Object entity, ReplicationMode replicationMode) Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.Persist the given transient instance.Persist the given transient instance.void
saveOrUpdate
(Object entity) Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?).void
saveOrUpdate
(String entityName, Object entity) Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?).void
Update the given persistent instance, associating it with the current HibernateSession
.void
Update the given persistent instance, associating it with the current HibernateSession
.void
Update the given persistent instance, associating it with the current HibernateSession
.void
Update the given persistent instance, associating it with the current HibernateSession
.
-
Method Details
-
execute
Execute the action specified by the given action object within aSession
.Application exceptions thrown by the action object get propagated to the caller (can only be unchecked). Hibernate exceptions are transformed into appropriate DAO ones. Allows for returning a result object, that is a domain object or a collection of domain objects.
Note: Callback code is not supposed to handle transactions itself! Use an appropriate transaction manager like
HibernateTransactionManager
. Generally, callback code must not touch anySession
lifecycle methods, like close, disconnect, or reconnect, to let the template do its work.- Parameters:
action
- callback object that specifies the Hibernate action- Returns:
- a result object returned by the action, or
null
- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
get
Return the persistent instance of the given entity class with the given identifier, ornull
if not found.This method is a thin wrapper around
Session.get(Class, Serializable)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entityClass
- a persistent classid
- the identifier of the persistent instance- Returns:
- the persistent instance, or
null
if not found - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
get
@Nullable <T> T get(Class<T> entityClass, Serializable id, LockMode lockMode) throws DataAccessException Return the persistent instance of the given entity class with the given identifier, ornull
if not found.Obtains the specified lock mode if the instance exists.
This method is a thin wrapper around
Session.get(Class, Serializable, LockMode)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entityClass
- a persistent classid
- the identifier of the persistent instancelockMode
- the lock mode to obtain- Returns:
- the persistent instance, or
null
if not found - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
get
Return the persistent instance of the given entity class with the given identifier, ornull
if not found.This method is a thin wrapper around
Session.get(String, Serializable)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entityName
- the name of the persistent entityid
- the identifier of the persistent instance- Returns:
- the persistent instance, or
null
if not found - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
get
@Nullable Object get(String entityName, Serializable id, LockMode lockMode) throws DataAccessException Return the persistent instance of the given entity class with the given identifier, ornull
if not found. Obtains the specified lock mode if the instance exists.This method is a thin wrapper around
Session.get(String, Serializable, LockMode)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entityName
- the name of the persistent entityid
- the identifier of the persistent instancelockMode
- the lock mode to obtain- Returns:
- the persistent instance, or
null
if not found - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
load
Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.This method is a thin wrapper around
Session.load(Class, Serializable)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entityClass
- a persistent classid
- the identifier of the persistent instance- Returns:
- the persistent instance
- Throws:
ObjectRetrievalFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
load
Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found. Obtains the specified lock mode if the instance exists.This method is a thin wrapper around
Session.load(Class, Serializable, LockMode)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entityClass
- a persistent classid
- the identifier of the persistent instancelockMode
- the lock mode to obtain- Returns:
- the persistent instance
- Throws:
ObjectRetrievalFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
load
Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.This method is a thin wrapper around
Session.load(String, Serializable)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entityName
- the name of the persistent entityid
- the identifier of the persistent instance- Returns:
- the persistent instance
- Throws:
ObjectRetrievalFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
load
Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.Obtains the specified lock mode if the instance exists.
This method is a thin wrapper around
Session.load(String, Serializable, LockMode)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entityName
- the name of the persistent entityid
- the identifier of the persistent instancelockMode
- the lock mode to obtain- Returns:
- the persistent instance
- Throws:
ObjectRetrievalFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
loadAll
Return all persistent instances of the given entity class. Note: Use queries or criteria for retrieving a specific subset.- Parameters:
entityClass
- a persistent class- Returns:
- a
List
containing 0 or more persistent instances - Throws:
DataAccessException
- if there is a Hibernate error- See Also:
-
load
Load the persistent instance with the given identifier into the given object, throwing an exception if not found.This method is a thin wrapper around
Session.load(Object, Serializable)
for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.- Parameters:
entity
- the object (of the target class) to load intoid
- the identifier of the persistent instance- Throws:
ObjectRetrievalFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
refresh
Re-read the state of the given persistent instance.- Parameters:
entity
- the persistent instance to re-read- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
refresh
Re-read the state of the given persistent instance. Obtains the specified lock mode for the instance.- Parameters:
entity
- the persistent instance to re-readlockMode
- the lock mode to obtain- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
contains
Check whether the given object is in the Session cache.- Parameters:
entity
- the persistence instance to check- Returns:
- whether the given object is in the Session cache
- Throws:
DataAccessException
- if there is a Hibernate error- See Also:
-
evict
Remove the given object from theSession
cache.- Parameters:
entity
- the persistent instance to evict- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
initialize
Force initialization of a Hibernate proxy or persistent collection.- Parameters:
proxy
- a proxy for a persistent object or a persistent collection- Throws:
DataAccessException
- if we can't initialize the proxy, for example because it is not associated with an active Session- See Also:
-
enableFilter
Return an enabled HibernateFilter
for the given filter name. The returnedFilter
instance can be used to set filter parameters.- Parameters:
filterName
- the name of the filter- Returns:
- the enabled Hibernate
Filter
(either already enabled or enabled on the fly by this operation) - Throws:
IllegalStateException
- if we are not running within a transactional Session (in which case this operation does not make sense)
-
lock
Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.- Parameters:
entity
- the persistent instance to locklockMode
- the lock mode to obtain- Throws:
ObjectOptimisticLockingFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
lock
Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.- Parameters:
entityName
- the name of the persistent entityentity
- the persistent instance to locklockMode
- the lock mode to obtain- Throws:
ObjectOptimisticLockingFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
save
Persist the given transient instance.- Parameters:
entity
- the transient instance to persist- Returns:
- the generated identifier
- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
save
Persist the given transient instance.- Parameters:
entityName
- the name of the persistent entityentity
- the transient instance to persist- Returns:
- the generated identifier
- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
update
Update the given persistent instance, associating it with the current HibernateSession
.- Parameters:
entity
- the persistent instance to update- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
update
Update the given persistent instance, associating it with the current HibernateSession
.Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.
- Parameters:
entity
- the persistent instance to updatelockMode
- the lock mode to obtain- Throws:
ObjectOptimisticLockingFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
update
Update the given persistent instance, associating it with the current HibernateSession
.- Parameters:
entityName
- the name of the persistent entityentity
- the persistent instance to update- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
update
Update the given persistent instance, associating it with the current HibernateSession
.Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.
- Parameters:
entityName
- the name of the persistent entityentity
- the persistent instance to updatelockMode
- the lock mode to obtain- Throws:
ObjectOptimisticLockingFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
saveOrUpdate
Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?). Associates the instance with the current HibernateSession
.- Parameters:
entity
- the persistent instance to save or update (to be associated with the HibernateSession
)- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
saveOrUpdate
Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?). Associates the instance with the current HibernateSession
.- Parameters:
entityName
- the name of the persistent entityentity
- the persistent instance to save or update (to be associated with the HibernateSession
)- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
replicate
Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.- Parameters:
entity
- the persistent object to replicatereplicationMode
- the Hibernate ReplicationMode- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
replicate
void replicate(String entityName, Object entity, ReplicationMode replicationMode) throws DataAccessException Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.- Parameters:
entityName
- the name of the persistent entityentity
- the persistent object to replicatereplicationMode
- the Hibernate ReplicationMode- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
persist
Persist the given transient instance. Follows JSR-220 semantics.Similar to
save
, associating the given object with the current HibernateSession
.- Parameters:
entity
- the persistent instance to persist- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
persist
Persist the given transient instance. Follows JSR-220 semantics.Similar to
save
, associating the given object with the current HibernateSession
.- Parameters:
entityName
- the name of the persistent entityentity
- the persistent instance to persist- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
merge
Copy the state of the given object onto the persistent object with the same identifier. Follows JSR-220 semantics.Similar to
saveOrUpdate
, but never associates the given object with the current Hibernate Session. In case of a new entity, the state will be copied over as well.Note that
merge
will not update the identifiers in the passed-in object graph (in contrast to TopLink)! Consider registering Spring'sIdTransferringMergeEventListener
if you would like to have newly assigned ids transferred to the original object graph too.- Parameters:
entity
- the object to merge with the corresponding persistence instance- Returns:
- the updated, registered persistent instance
- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
merge
Copy the state of the given object onto the persistent object with the same identifier. Follows JSR-220 semantics.Similar to
saveOrUpdate
, but never associates the given object with the current HibernateSession
. In the case of a new entity, the state will be copied over as well.Note that
merge
will not update the identifiers in the passed-in object graph (in contrast to TopLink)! Consider registering Spring'sIdTransferringMergeEventListener
if you would like to have newly assigned ids transferred to the original object graph too.- Parameters:
entityName
- the name of the persistent entityentity
- the object to merge with the corresponding persistence instance- Returns:
- the updated, registered persistent instance
- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
delete
Delete the given persistent instance.- Parameters:
entity
- the persistent instance to delete- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
delete
Delete the given persistent instance.Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.
- Parameters:
entity
- the persistent instance to deletelockMode
- the lock mode to obtain- Throws:
ObjectOptimisticLockingFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
delete
Delete the given persistent instance.- Parameters:
entityName
- the name of the persistent entityentity
- the persistent instance to delete- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
delete
Delete the given persistent instance.Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.
- Parameters:
entityName
- the name of the persistent entityentity
- the persistent instance to deletelockMode
- the lock mode to obtain- Throws:
ObjectOptimisticLockingFailureException
- if not foundDataAccessException
- in case of Hibernate errors- See Also:
-
deleteAll
Delete all given persistent instances.This can be combined with any of the find methods to delete by query in two lines of code.
- Parameters:
entities
- the persistent instances to delete- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
flush
Flush all pending saves, updates and deletes to the database.Only invoke this for selective eager flushing, for example when JDBC code needs to see certain changes within the same transaction. Else, it is preferable to rely on auto-flushing at transaction completion.
- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
clear
Remove all objects from theSession
cache, and cancel all pending saves, updates and deletes.- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByCriteria
Execute a query based on a given Hibernate criteria object.- Parameters:
criteria
- the detached Hibernate criteria object. Note: Do not reuse criteria objects! They need to recreated per execution, due to the suboptimal design of Hibernate's criteria facility.- Returns:
- a
List
containing 0 or more persistent instances - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByCriteria
List<?> findByCriteria(DetachedCriteria criteria, int firstResult, int maxResults) throws DataAccessException Execute a query based on the given Hibernate criteria object.- Parameters:
criteria
- the detached Hibernate criteria object. Note: Do not reuse criteria objects! They need to recreated per execution, due to the suboptimal design of Hibernate's criteria facility.firstResult
- the index of the first result object to be retrieved (numbered from 0)maxResults
- the maximum number of result objects to retrieve (or <=0 for no limit)- Returns:
- a
List
containing 0 or more persistent instances - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByExample
Execute a query based on the given example entity object.- Parameters:
exampleEntity
- an instance of the desired entity, serving as example for "query-by-example"- Returns:
- a
List
containing 0 or more persistent instances - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByExample
Execute a query based on the given example entity object.- Parameters:
entityName
- the name of the persistent entityexampleEntity
- an instance of the desired entity, serving as example for "query-by-example"- Returns:
- a
List
containing 0 or more persistent instances - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByExample
<T> List<T> findByExample(T exampleEntity, int firstResult, int maxResults) throws DataAccessException Execute a query based on a given example entity object.- Parameters:
exampleEntity
- an instance of the desired entity, serving as example for "query-by-example"firstResult
- the index of the first result object to be retrieved (numbered from 0)maxResults
- the maximum number of result objects to retrieve (or <=0 for no limit)- Returns:
- a
List
containing 0 or more persistent instances - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByExample
<T> List<T> findByExample(String entityName, T exampleEntity, int firstResult, int maxResults) throws DataAccessException Execute a query based on a given example entity object.- Parameters:
entityName
- the name of the persistent entityexampleEntity
- an instance of the desired entity, serving as example for "query-by-example"firstResult
- the index of the first result object to be retrieved (numbered from 0)maxResults
- the maximum number of result objects to retrieve (or <=0 for no limit)- Returns:
- a
List
containing 0 or more persistent instances - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
find
Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute an HQL query, binding a number of values to "?" parameters in the query string.- Parameters:
queryString
- a query expressed in Hibernate's query languagevalues
- the values of the parameters- Returns:
- a
List
containing the results of the query execution - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByNamedParam
@Deprecated List<?> findByNamedParam(String queryString, String paramName, Object value) throws DataAccessException Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute an HQL query, binding one value to a ":" named parameter in the query string.- Parameters:
queryString
- a query expressed in Hibernate's query languageparamName
- the name of the parametervalue
- the value of the parameter- Returns:
- a
List
containing the results of the query execution - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByNamedParam
@Deprecated List<?> findByNamedParam(String queryString, String[] paramNames, Object[] values) throws DataAccessException Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute an HQL query, binding a number of values to ":" named parameters in the query string.- Parameters:
queryString
- a query expressed in Hibernate's query languageparamNames
- the names of the parametersvalues
- the values of the parameters- Returns:
- a
List
containing the results of the query execution - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByValueBean
@Deprecated List<?> findByValueBean(String queryString, Object valueBean) throws DataAccessException Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute an HQL query, binding the properties of the given bean to named parameters in the query string.- Parameters:
queryString
- a query expressed in Hibernate's query languagevalueBean
- the values of the parameters- Returns:
- a
List
containing the results of the query execution - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByNamedQuery
Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute a named query binding a number of values to "?" parameters in the query string.A named query is defined in a Hibernate mapping file.
- Parameters:
queryName
- the name of a Hibernate query in a mapping filevalues
- the values of the parameters- Returns:
- a
List
containing the results of the query execution - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByNamedQueryAndNamedParam
@Deprecated List<?> findByNamedQueryAndNamedParam(String queryName, String paramName, Object value) throws DataAccessException Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute a named query, binding one value to a ":" named parameter in the query string.A named query is defined in a Hibernate mapping file.
- Parameters:
queryName
- the name of a Hibernate query in a mapping fileparamName
- the name of parametervalue
- the value of the parameter- Returns:
- a
List
containing the results of the query execution - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByNamedQueryAndNamedParam
@Deprecated List<?> findByNamedQueryAndNamedParam(String queryName, String[] paramNames, Object[] values) throws DataAccessException Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute a named query, binding a number of values to ":" named parameters in the query string.A named query is defined in a Hibernate mapping file.
- Parameters:
queryName
- the name of a Hibernate query in a mapping fileparamNames
- the names of the parametersvalues
- the values of the parameters- Returns:
- a
List
containing the results of the query execution - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
findByNamedQueryAndValueBean
@Deprecated List<?> findByNamedQueryAndValueBean(String queryName, Object valueBean) throws DataAccessException Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute a named query, binding the properties of the given bean to ":" named parameters in the query string.A named query is defined in a Hibernate mapping file.
- Parameters:
queryName
- the name of a Hibernate query in a mapping filevalueBean
- the values of the parameters- Returns:
- a
List
containing the results of the query execution - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
iterate
Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodExecute a query for persistent instances, binding a number of values to "?" parameters in the query string.Returns the results as an
Iterator
. Entities returned are initialized on demand. See the Hibernate API documentation for details.- Parameters:
queryString
- a query expressed in Hibernate's query languagevalues
- the values of the parameters- Returns:
- an
Iterator
containing 0 or more persistent instances - Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
closeIterator
Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodImmediately close anIterator
created by any of the variousiterate(..)
operations, instead of waiting until the session is closed or disconnected.- Parameters:
it
- theIterator
to close- Throws:
DataAccessException
- if theIterator
could not be closed- See Also:
-
bulkUpdate
Deprecated.as of 5.0.4, in favor of a customHibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
methodUpdate/delete all objects according to the given query, binding a number of values to "?" parameters in the query string.- Parameters:
queryString
- an update/delete query expressed in Hibernate's query languagevalues
- the values of the parameters- Returns:
- the number of instances updated/deleted
- Throws:
DataAccessException
- in case of Hibernate errors- See Also:
-
HibernateCallback
lambda code block passed to the generalexecute(org.springframework.orm.hibernate5.HibernateCallback<T>)
method