org.springframework.orm.hibernate4

Class HibernateTemplate

java.lang.Object

org.springframework.orm.hibernate4.HibernateTemplate

All Implemented Interfaces:

InitializingBean, HibernateOperations

public class HibernateTemplate
extends java.lang.Object
implements HibernateOperations, InitializingBean

Helper class that simplifies Hibernate data access code. Automatically converts HibernateExceptions into DataAccessExceptions, following the org.springframework.dao exception hierarchy.

The central method is execute, supporting Hibernate access code implementing the HibernateCallback interface. It provides Hibernate Session handling such that neither the HibernateCallback implementation nor the calling code needs to explicitly care about retrieving/closing Hibernate Sessions, or handling Session lifecycle exceptions. For typical single step actions, there are various convenience methods (find, load, saveOrUpdate, delete).

Can be used within a service implementation via direct instantiation with a SessionFactory reference, or get prepared in an application context and given to services as bean reference. Note: The SessionFactory should always be configured as bean in the application context, in the first case given to the service directly, in the second case to the prepared template.

NOTE: Hibernate access code can also be coded in plain Hibernate style. Hence, for newly started projects, consider adopting the standard Hibernate style of coding data access objects instead, based on SessionFactory.getCurrentSession(). This HibernateTemplate primarily exists as a migration helper for Hibernate 3 based data access code, to benefit from bug fixes in Hibernate 4.x.

Since:

4.0.1

Author:

Juergen Hoeller

See Also:

setSessionFactory(org.hibernate.SessionFactory), HibernateCallback, Session, LocalSessionFactoryBean, HibernateTransactionManager, OpenSessionInViewFilter, OpenSessionInViewInterceptor

Field Summary

Fields

Modifier and Type	Field and Description
protected Log	logger

Constructor Summary

Constructors

Constructor and Description
HibernateTemplate() Create a new HibernateTemplate instance.
HibernateTemplate(SessionFactory sessionFactory) Create a new HibernateTemplate instance.

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
protected void	applyNamedParameterToQuery(Query queryObject, java.lang.String paramName, java.lang.Object value) Apply the given name parameter to the given Query object.
int	bulkUpdate(java.lang.String queryString, java.lang.Object... values) Update/delete all objects according to the given query, binding a number of values to "?" parameters in the query string.
protected void	checkWriteOperationAllowed(Session session) Check whether write operations are allowed on the given Session.
void	clear() Remove all objects from the Session cache, and cancel all pending saves, updates and deletes.
void	closeIterator(java.util.Iterator<?> it) Immediately close an Iterator created by any of the various iterate(..) operations, instead of waiting until the session is closed or disconnected.
boolean	contains(java.lang.Object entity) Check whether the given object is in the Session cache.
protected Session	createSessionProxy(Session session) Create a close-suppressing proxy for the given Hibernate Session.
void	delete(java.lang.Object entity) Delete the given persistent instance.
void	delete(java.lang.Object entity, LockMode lockMode) Delete the given persistent instance.
void	delete(java.lang.String entityName, java.lang.Object entity) Delete the given persistent instance.
void	delete(java.lang.String entityName, java.lang.Object entity, LockMode lockMode) Delete the given persistent instance.
void	deleteAll(java.util.Collection<?> entities) Delete all given persistent instances.
protected void	disableFilters(Session session) Disable the specified filters on the given Session.
protected <T> T	doExecute(HibernateCallback<T> action, boolean enforceNativeSession) Execute the action specified by the given action object within a Session.
Filter	enableFilter(java.lang.String filterName) Return an enabled Hibernate Filter for the given filter name.
protected void	enableFilters(Session session) Enable the specified filters on the given Session.
void	evict(java.lang.Object entity) Remove the given object from the Session cache.
<T> T	execute(HibernateCallback<T> action) Execute the action specified by the given action object within a Session.
<T> T	executeWithNativeSession(HibernateCallback<T> action) Execute the action specified by the given action object within a native Session.
java.util.List<?>	find(java.lang.String queryString, java.lang.Object... values) Execute an HQL query, binding a number of values to "?" parameters in the query string.
java.util.List<?>	findByCriteria(DetachedCriteria criteria) Execute a query based on a given Hibernate criteria object.
java.util.List<?>	findByCriteria(DetachedCriteria criteria, int firstResult, int maxResults) Execute a query based on the given Hibernate criteria object.
<T> java.util.List<T>	findByExample(java.lang.String entityName, T exampleEntity) Execute a query based on the given example entity object.
<T> java.util.List<T>	findByExample(java.lang.String entityName, T exampleEntity, int firstResult, int maxResults) Execute a query based on a given example entity object.
<T> java.util.List<T>	findByExample(T exampleEntity) Execute a query based on the given example entity object.
<T> java.util.List<T>	findByExample(T exampleEntity, int firstResult, int maxResults) Execute a query based on a given example entity object.
java.util.List<?>	findByNamedParam(java.lang.String queryString, java.lang.String[] paramNames, java.lang.Object[] values) Execute an HQL query, binding a number of values to ":" named parameters in the query string.
java.util.List<?>	findByNamedParam(java.lang.String queryString, java.lang.String paramName, java.lang.Object value) Execute an HQL query, binding one value to a ":" named parameter in the query string.
java.util.List<?>	findByNamedQuery(java.lang.String queryName, java.lang.Object... values) Execute a named query binding a number of values to "?" parameters in the query string.
java.util.List<?>	findByNamedQueryAndNamedParam(java.lang.String queryName, java.lang.String[] paramNames, java.lang.Object[] values) Execute a named query, binding a number of values to ":" named parameters in the query string.
java.util.List<?>	findByNamedQueryAndNamedParam(java.lang.String queryName, java.lang.String paramName, java.lang.Object value) Execute a named query, binding one value to a ":" named parameter in the query string.
java.util.List<?>	findByNamedQueryAndValueBean(java.lang.String queryName, java.lang.Object valueBean) Execute a named query, binding the properties of the given bean to ":" named parameters in the query string.
java.util.List<?>	findByValueBean(java.lang.String queryString, java.lang.Object valueBean) Execute an HQL query, binding the properties of the given bean to named parameters in the query string.
void	flush() Flush all pending saves, updates and deletes to the database.
<T> T	get(java.lang.Class<T> entityClass, java.io.Serializable id) Return the persistent instance of the given entity class with the given identifier, or null if not found.
<T> T	get(java.lang.Class<T> entityClass, java.io.Serializable id, LockMode lockMode) Return the persistent instance of the given entity class with the given identifier, or null if not found.
java.lang.Object	get(java.lang.String entityName, java.io.Serializable id) Return the persistent instance of the given entity class with the given identifier, or null if not found.
java.lang.Object	get(java.lang.String entityName, java.io.Serializable id, LockMode lockMode) Return the persistent instance of the given entity class with the given identifier, or null if not found.
int	getFetchSize() Return the fetch size specified for this HibernateTemplate.
java.lang.String[]	getFilterNames() Return the names of Hibernate filters to be activated, if any.
int	getMaxResults() Return the maximum number of rows specified for this HibernateTemplate.
java.lang.String	getQueryCacheRegion() Return the name of the cache region for queries executed by this template.
SessionFactory	getSessionFactory() Return the Hibernate SessionFactory that should be used to create Hibernate Sessions.
void	initialize(java.lang.Object proxy) Force initialization of a Hibernate proxy or persistent collection.
boolean	isCacheQueries() Return whether to cache all queries executed by this template.
boolean	isCheckWriteOperations() Return whether to check that the Hibernate Session is not in read-only mode in case of write operations (save/update/delete).
boolean	isExposeNativeSession() Return whether to expose the native Hibernate Session to HibernateCallback code, or rather a Session proxy.
java.util.Iterator<?>	iterate(java.lang.String queryString, java.lang.Object... values) Execute a query for persistent instances, binding a number of values to "?" parameters in the query string.
<T> T	load(java.lang.Class<T> entityClass, java.io.Serializable id) Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.
<T> T	load(java.lang.Class<T> entityClass, java.io.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(java.lang.Object entity, java.io.Serializable id) Load the persistent instance with the given identifier into the given object, throwing an exception if not found.
java.lang.Object	load(java.lang.String entityName, java.io.Serializable id) Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.
java.lang.Object	load(java.lang.String entityName, java.io.Serializable id, LockMode lockMode) Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.
<T> java.util.List<T>	loadAll(java.lang.Class<T> entityClass) Return all persistent instances of the given entity class.
void	lock(java.lang.Object entity, LockMode lockMode) Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.
void	lock(java.lang.String entityName, java.lang.Object entity, LockMode lockMode) Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.
<T> T	merge(java.lang.String entityName, T entity) 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(java.lang.Object entity) Persist the given transient instance.
void	persist(java.lang.String entityName, java.lang.Object entity) Persist the given transient instance.
protected void	prepareCriteria(Criteria criteria) Prepare the given Criteria object, applying cache settings and/or a transaction timeout.
protected void	prepareQuery(Query queryObject) Prepare the given Query object, applying cache settings and/or a transaction timeout.
void	refresh(java.lang.Object entity) Re-read the state of the given persistent instance.
void	refresh(java.lang.Object entity, LockMode lockMode) Re-read the state of the given persistent instance.
void	replicate(java.lang.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(java.lang.String entityName, java.lang.Object entity, ReplicationMode replicationMode) Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.
java.io.Serializable	save(java.lang.Object entity) Persist the given transient instance.
java.io.Serializable	save(java.lang.String entityName, java.lang.Object entity) Persist the given transient instance.
void	saveOrUpdate(java.lang.Object entity) Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?).
void	saveOrUpdate(java.lang.String entityName, java.lang.Object entity) Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?).
void	setCacheQueries(boolean cacheQueries) Set whether to cache all queries executed by this template.
void	setCheckWriteOperations(boolean checkWriteOperations) Set whether to check that the Hibernate Session is not in read-only mode in case of write operations (save/update/delete).
void	setExposeNativeSession(boolean exposeNativeSession) Set whether to expose the native Hibernate Session to HibernateCallback code.
void	setFetchSize(int fetchSize) Set the fetch size for this HibernateTemplate.
void	setFilterNames(java.lang.String... filterNames) Set one or more names of Hibernate filters to be activated for all Sessions that this accessor works with.
void	setMaxResults(int maxResults) Set the maximum number of rows for this HibernateTemplate.
void	setQueryCacheRegion(java.lang.String queryCacheRegion) Set the name of the cache region for queries executed by this template.
void	setSessionFactory(SessionFactory sessionFactory) Set the Hibernate SessionFactory that should be used to create Hibernate Sessions.
void	update(java.lang.Object entity) Update the given persistent instance, associating it with the current Hibernate Session.
void	update(java.lang.Object entity, LockMode lockMode) Update the given persistent instance, associating it with the current Hibernate Session.
void	update(java.lang.String entityName, java.lang.Object entity) Update the given persistent instance, associating it with the current Hibernate Session.
void	update(java.lang.String entityName, java.lang.Object entity, LockMode lockMode) Update the given persistent instance, associating it with the current Hibernate Session.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final Log logger

Constructor Detail

HibernateTemplate

public HibernateTemplate()

Create a new HibernateTemplate instance.

HibernateTemplate

public HibernateTemplate(SessionFactory sessionFactory)

Create a new HibernateTemplate instance.

Parameters:

sessionFactory - the SessionFactory to create Sessions with

Method Detail

setSessionFactory

public void setSessionFactory(SessionFactory sessionFactory)

Set the Hibernate SessionFactory that should be used to create Hibernate Sessions.

getSessionFactory

public SessionFactory getSessionFactory()

Return the Hibernate SessionFactory that should be used to create Hibernate Sessions.

setFilterNames

public void setFilterNames(java.lang.String... filterNames)

Set one or more names of Hibernate filters to be activated for all Sessions that this accessor works with.

Each of those filters will be enabled at the beginning of each operation and correspondingly disabled at the end of the operation. This will work for newly opened Sessions as well as for existing Sessions (for example, within a transaction).

See Also:

enableFilters(org.hibernate.Session), Session.enableFilter(String)

getFilterNames

public java.lang.String[] getFilterNames()

Return the names of Hibernate filters to be activated, if any.

setExposeNativeSession

public void setExposeNativeSession(boolean exposeNativeSession)

Set whether to expose the native Hibernate Session to HibernateCallback code.

Default is "false": a Session proxy will be returned, suppressing close calls and automatically applying query cache settings and transaction timeouts.

See Also:

HibernateCallback, Session, setCacheQueries(boolean), setQueryCacheRegion(java.lang.String), prepareQuery(org.hibernate.Query), prepareCriteria(org.hibernate.Criteria)

isExposeNativeSession

public boolean isExposeNativeSession()

Return whether to expose the native Hibernate Session to HibernateCallback code, or rather a Session proxy.

setCheckWriteOperations

public void setCheckWriteOperations(boolean checkWriteOperations)

Set whether to check that the Hibernate Session is not in read-only mode in case of write operations (save/update/delete).

Default is "true", for fail-fast behavior when attempting write operations within a read-only transaction. Turn this off to allow save/update/delete on a Session with flush mode MANUAL.

See Also:

checkWriteOperationAllowed(org.hibernate.Session), TransactionDefinition.isReadOnly()

isCheckWriteOperations

public boolean isCheckWriteOperations()

Return whether to check that the Hibernate Session is not in read-only mode in case of write operations (save/update/delete).

setCacheQueries

public void setCacheQueries(boolean cacheQueries)

Set whether to cache all queries executed by this template.

If this is "true", all Query and Criteria objects created by this template will be marked as cacheable (including all queries through find methods).

To specify the query region to be used for queries cached by this template, set the "queryCacheRegion" property.

See Also:

setQueryCacheRegion(java.lang.String), Query.setCacheable(boolean), Criteria.setCacheable(boolean)

isCacheQueries

public boolean isCacheQueries()

Return whether to cache all queries executed by this template.

setQueryCacheRegion

public void setQueryCacheRegion(java.lang.String queryCacheRegion)

Set the name of the cache region for queries executed by this template.

If this is specified, it will be applied to all Query and Criteria objects created by this template (including all queries through find methods).

The cache region will not take effect unless queries created by this template are configured to be cached via the "cacheQueries" property.

See Also:

setCacheQueries(boolean), Query.setCacheRegion(java.lang.String), Criteria.setCacheRegion(java.lang.String)

getQueryCacheRegion

public java.lang.String getQueryCacheRegion()

Return the name of the cache region for queries executed by this template.

setFetchSize

public void setFetchSize(int fetchSize)

Set the fetch size for this HibernateTemplate. This is important for processing large result sets: Setting this higher than the default value will increase processing speed at the cost of memory consumption; setting this lower can avoid transferring row data that will never be read by the application.

Default is 0, indicating to use the JDBC driver's default.

getFetchSize

public int getFetchSize()

Return the fetch size specified for this HibernateTemplate.

setMaxResults

public void setMaxResults(int maxResults)

Set the maximum number of rows for this HibernateTemplate. This is important for processing subsets of large result sets, avoiding to read and hold the entire result set in the database or in the JDBC driver if we're never interested in the entire result in the first place (for example, when performing searches that might return a large number of matches).

Default is 0, indicating to use the JDBC driver's default.

getMaxResults

public int getMaxResults()

Return the maximum number of rows specified for this HibernateTemplate.

afterPropertiesSet

public void afterPropertiesSet()

Description copied from interface: InitializingBean

Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).

This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.

Specified by:

afterPropertiesSet in interface InitializingBean

execute

public <T> T execute(HibernateCallback<T> action)
              throws DataAccessException

Description copied from interface: HibernateOperations

Execute the action specified by the given action object within a Session.

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 any Session lifecycle methods, like close, disconnect, or reconnect, to let the template do its work.

Specified by:

execute in interface HibernateOperations

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:

HibernateTransactionManager, Session

executeWithNativeSession

public <T> T executeWithNativeSession(HibernateCallback<T> action)

Execute the action specified by the given action object within a native Session.

This execute variant overrides the template-wide "exposeNativeSession" setting.

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

doExecute

protected <T> T doExecute(HibernateCallback<T> action,
                          boolean enforceNativeSession)
                   throws DataAccessException

Execute the action specified by the given action object within a Session.

Parameters:

action - callback object that specifies the Hibernate action

enforceNativeSession - whether to enforce exposure of the native Hibernate Session to callback code

Returns:

a result object returned by the action, or null

Throws:

DataAccessException - in case of Hibernate errors

createSessionProxy

protected Session createSessionProxy(Session session)

Create a close-suppressing proxy for the given Hibernate Session. The proxy also prepares returned Query and Criteria objects.

Parameters:

session - the Hibernate Session to create a proxy for

Returns:

the Session proxy

See Also:

Session.close(), prepareQuery(org.hibernate.Query), prepareCriteria(org.hibernate.Criteria)

enableFilters

protected void enableFilters(Session session)

Enable the specified filters on the given Session.

Parameters:

session - the current Hibernate Session

See Also:

setFilterNames(java.lang.String...), Session.enableFilter(String)

disableFilters

protected void disableFilters(Session session)

Disable the specified filters on the given Session.

Parameters:

session - the current Hibernate Session

See Also:

setFilterNames(java.lang.String...), Session.disableFilter(String)

get

public <T> T get(java.lang.Class<T> entityClass,
                 java.io.Serializable id)
          throws DataAccessException

Description copied from interface: HibernateOperations

Return the persistent instance of the given entity class with the given identifier, or null if not found.

This method is a thin wrapper around Session.get(Class, java.io.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.

Specified by:

get in interface HibernateOperations

Parameters:

entityClass - a persistent class

id - the identifier of the persistent instance

Returns:

the persistent instance, or null if not found

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.get(Class, java.io.Serializable)

get

public <T> T get(java.lang.Class<T> entityClass,
                 java.io.Serializable id,
                 LockMode lockMode)
          throws DataAccessException

Description copied from interface: HibernateOperations

Return the persistent instance of the given entity class with the given identifier, or null if not found.

Obtains the specified lock mode if the instance exists.

This method is a thin wrapper around Session.get(Class, java.io.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.

Specified by:

get in interface HibernateOperations

Parameters:

entityClass - a persistent class

id - the identifier of the persistent instance

lockMode - the lock mode to obtain

Returns:

the persistent instance, or null if not found

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.get(Class, java.io.Serializable, org.hibernate.LockMode)

get

public java.lang.Object get(java.lang.String entityName,
                            java.io.Serializable id)
                     throws DataAccessException

Description copied from interface: HibernateOperations

Return the persistent instance of the given entity class with the given identifier, or null if not found.

This method is a thin wrapper around Session.get(String, java.io.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.

Specified by:

get in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

id - the identifier of the persistent instance

Returns:

the persistent instance, or null if not found

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.get(Class, java.io.Serializable)

get

public java.lang.Object get(java.lang.String entityName,
                            java.io.Serializable id,
                            LockMode lockMode)
                     throws DataAccessException

Description copied from interface: HibernateOperations

Return the persistent instance of the given entity class with the given identifier, or null if not found. Obtains the specified lock mode if the instance exists.

This method is a thin wrapper around Session.get(String, java.io.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.

Specified by:

get in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

id - the identifier of the persistent instance

lockMode - the lock mode to obtain

Returns:

the persistent instance, or null if not found

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.get(Class, java.io.Serializable, org.hibernate.LockMode)

load

public <T> T load(java.lang.Class<T> entityClass,
                  java.io.Serializable id)
           throws DataAccessException

Description copied from interface: HibernateOperations

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, java.io.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.

Specified by:

load in interface HibernateOperations

Parameters:

entityClass - a persistent class

id - the identifier of the persistent instance

Returns:

the persistent instance

Throws:

ObjectRetrievalFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.load(Class, java.io.Serializable)

load

public <T> T load(java.lang.Class<T> entityClass,
                  java.io.Serializable id,
                  LockMode lockMode)
           throws DataAccessException

Description copied from interface: HibernateOperations

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, java.io.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.

Specified by:

load in interface HibernateOperations

Parameters:

entityClass - a persistent class

id - the identifier of the persistent instance

lockMode - the lock mode to obtain

Returns:

the persistent instance

Throws:

ObjectRetrievalFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.load(Class, java.io.Serializable)

load

public java.lang.Object load(java.lang.String entityName,
                             java.io.Serializable id)
                      throws DataAccessException

Description copied from interface: HibernateOperations

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, java.io.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.

Specified by:

load in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

id - the identifier of the persistent instance

Returns:

the persistent instance

Throws:

ObjectRetrievalFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.load(Class, java.io.Serializable)

load

public java.lang.Object load(java.lang.String entityName,
                             java.io.Serializable id,
                             LockMode lockMode)
                      throws DataAccessException

Description copied from interface: HibernateOperations

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, java.io.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.

Specified by:

load in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

id - the identifier of the persistent instance

lockMode - the lock mode to obtain

Returns:

the persistent instance

Throws:

ObjectRetrievalFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.load(Class, java.io.Serializable)

loadAll

public <T> java.util.List<T> loadAll(java.lang.Class<T> entityClass)
                              throws DataAccessException

Description copied from interface: HibernateOperations

Return all persistent instances of the given entity class. Note: Use queries or criteria for retrieving a specific subset.

Specified by:

loadAll in interface HibernateOperations

Parameters:

entityClass - a persistent class

Returns:

a List containing 0 or more persistent instances

Throws:

DataAccessException - if there is a Hibernate error

See Also:

SharedSessionContract.createCriteria(java.lang.Class)

load

public void load(java.lang.Object entity,
                 java.io.Serializable id)
          throws DataAccessException

Description copied from interface: HibernateOperations

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, java.io.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.

Specified by:

load in interface HibernateOperations

Parameters:

entity - the object (of the target class) to load into

id - the identifier of the persistent instance

Throws:

ObjectRetrievalFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.load(Object, java.io.Serializable)

refresh

public void refresh(java.lang.Object entity)
             throws DataAccessException

Description copied from interface: HibernateOperations

Re-read the state of the given persistent instance.

Specified by:

refresh in interface HibernateOperations

Parameters:

entity - the persistent instance to re-read

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.refresh(Object)

refresh

public void refresh(java.lang.Object entity,
                    LockMode lockMode)
             throws DataAccessException

Description copied from interface: HibernateOperations

Re-read the state of the given persistent instance. Obtains the specified lock mode for the instance.

Specified by:

refresh in interface HibernateOperations

Parameters:

entity - the persistent instance to re-read

lockMode - the lock mode to obtain

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.refresh(Object, org.hibernate.LockMode)

contains

public boolean contains(java.lang.Object entity)
                 throws DataAccessException

Description copied from interface: HibernateOperations

Check whether the given object is in the Session cache.

Specified by:

contains in interface HibernateOperations

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:

Session.contains(java.lang.Object)

evict

public void evict(java.lang.Object entity)
           throws DataAccessException

Description copied from interface: HibernateOperations

Remove the given object from the Session cache.

Specified by:

evict in interface HibernateOperations

Parameters:

entity - the persistent instance to evict

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.evict(java.lang.Object)

initialize

public void initialize(java.lang.Object proxy)
                throws DataAccessException

Description copied from interface: HibernateOperations

Force initialization of a Hibernate proxy or persistent collection.

Specified by:

initialize in interface HibernateOperations

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:

Hibernate.initialize(java.lang.Object)

enableFilter

public Filter enableFilter(java.lang.String filterName)
                    throws java.lang.IllegalStateException

Description copied from interface: HibernateOperations

Return an enabled Hibernate Filter for the given filter name. The returned Filter instance can be used to set filter parameters.

Specified by:

enableFilter in interface HibernateOperations

Parameters:

filterName - the name of the filter

Returns:

the enabled Hibernate Filter (either already enabled or enabled on the fly by this operation)

Throws:

java.lang.IllegalStateException - if we are not running within a transactional Session (in which case this operation does not make sense)

lock

public void lock(java.lang.Object entity,
                 LockMode lockMode)
          throws DataAccessException

Description copied from interface: HibernateOperations

Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.

Specified by:

lock in interface HibernateOperations

Parameters:

entity - the persistent instance to lock

lockMode - the lock mode to obtain

Throws:

ObjectOptimisticLockingFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.lock(Object, org.hibernate.LockMode)

lock

public void lock(java.lang.String entityName,
                 java.lang.Object entity,
                 LockMode lockMode)
          throws DataAccessException

Description copied from interface: HibernateOperations

Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.

Specified by:

lock in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the persistent instance to lock

lockMode - the lock mode to obtain

Throws:

ObjectOptimisticLockingFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.lock(String, Object, org.hibernate.LockMode)

save

public java.io.Serializable save(java.lang.Object entity)
                          throws DataAccessException

Description copied from interface: HibernateOperations

Persist the given transient instance.

Specified by:

save in interface HibernateOperations

Parameters:

entity - the transient instance to persist

Returns:

the generated identifier

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.save(Object)

save

public java.io.Serializable save(java.lang.String entityName,
                                 java.lang.Object entity)
                          throws DataAccessException

Description copied from interface: HibernateOperations

Persist the given transient instance.

Specified by:

save in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the transient instance to persist

Returns:

the generated identifier

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.save(String, Object)

update

public void update(java.lang.Object entity)
            throws DataAccessException

Description copied from interface: HibernateOperations

Update the given persistent instance, associating it with the current Hibernate Session.

Specified by:

update in interface HibernateOperations

Parameters:

entity - the persistent instance to update

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.update(Object)

update

public void update(java.lang.Object entity,
                   LockMode lockMode)
            throws DataAccessException

Description copied from interface: HibernateOperations

Update the given persistent instance, associating it with the current Hibernate Session.

Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.

Specified by:

update in interface HibernateOperations

Parameters:

entity - the persistent instance to update

lockMode - the lock mode to obtain

Throws:

ObjectOptimisticLockingFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.update(Object)

update

public void update(java.lang.String entityName,
                   java.lang.Object entity)
            throws DataAccessException

Description copied from interface: HibernateOperations

Update the given persistent instance, associating it with the current Hibernate Session.

Specified by:

update in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the persistent instance to update

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.update(String, Object)

update

public void update(java.lang.String entityName,
                   java.lang.Object entity,
                   LockMode lockMode)
            throws DataAccessException

Description copied from interface: HibernateOperations

Update the given persistent instance, associating it with the current Hibernate Session.

Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.

Specified by:

update in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the persistent instance to update

lockMode - the lock mode to obtain

Throws:

ObjectOptimisticLockingFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.update(String, Object)

saveOrUpdate

public void saveOrUpdate(java.lang.Object entity)
                  throws DataAccessException

Description copied from interface: HibernateOperations

Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?). Associates the instance with the current Hibernate Session.

Specified by:

saveOrUpdate in interface HibernateOperations

Parameters:

entity - the persistent instance to save or update (to be associated with the Hibernate Session)

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.saveOrUpdate(Object)

saveOrUpdate

public void saveOrUpdate(java.lang.String entityName,
                         java.lang.Object entity)
                  throws DataAccessException

Description copied from interface: HibernateOperations

Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?). Associates the instance with the current Hibernate Session.

Specified by:

saveOrUpdate in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the persistent instance to save or update (to be associated with the Hibernate Session)

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.saveOrUpdate(String, Object)

replicate

public void replicate(java.lang.Object entity,
                      ReplicationMode replicationMode)
               throws DataAccessException

Description copied from interface: HibernateOperations

Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.

Specified by:

replicate in interface HibernateOperations

Parameters:

entity - the persistent object to replicate

replicationMode - the Hibernate ReplicationMode

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.replicate(Object, org.hibernate.ReplicationMode)

replicate

public void replicate(java.lang.String entityName,
                      java.lang.Object entity,
                      ReplicationMode replicationMode)
               throws DataAccessException

Description copied from interface: HibernateOperations

Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.

Specified by:

replicate in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the persistent object to replicate

replicationMode - the Hibernate ReplicationMode

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.replicate(String, Object, org.hibernate.ReplicationMode)

persist

public void persist(java.lang.Object entity)
             throws DataAccessException

Description copied from interface: HibernateOperations

Persist the given transient instance. Follows JSR-220 semantics.

Similar to save, associating the given object with the current Hibernate Session.

Specified by:

persist in interface HibernateOperations

Parameters:

entity - the persistent instance to persist

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.persist(Object), HibernateOperations.save(java.lang.Object)

persist

public void persist(java.lang.String entityName,
                    java.lang.Object entity)
             throws DataAccessException

Description copied from interface: HibernateOperations

Persist the given transient instance. Follows JSR-220 semantics.

Similar to save, associating the given object with the current Hibernate Session.

Specified by:

persist in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the persistent instance to persist

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.persist(String, Object), HibernateOperations.save(java.lang.Object)

merge

public <T> T merge(T entity)
            throws DataAccessException

Description copied from interface: HibernateOperations

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's IdTransferringMergeEventListener if you would like to have newly assigned ids transferred to the original object graph too.

Specified by:

merge in interface HibernateOperations

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:

Session.merge(Object), HibernateOperations.saveOrUpdate(java.lang.Object)

merge

public <T> T merge(java.lang.String entityName,
                   T entity)
            throws DataAccessException

Description copied from interface: HibernateOperations

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 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's IdTransferringMergeEventListener if you would like to have newly assigned ids transferred to the original object graph too.

Specified by:

merge in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

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:

Session.merge(String, Object), HibernateOperations.saveOrUpdate(java.lang.Object)

delete

public void delete(java.lang.Object entity)
            throws DataAccessException

Description copied from interface: HibernateOperations

Delete the given persistent instance.

Specified by:

delete in interface HibernateOperations

Parameters:

entity - the persistent instance to delete

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.delete(Object)

delete

public void delete(java.lang.Object entity,
                   LockMode lockMode)
            throws DataAccessException

Description copied from interface: HibernateOperations

Delete the given persistent instance.

Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.

Specified by:

delete in interface HibernateOperations

Parameters:

entity - the persistent instance to delete

lockMode - the lock mode to obtain

Throws:

ObjectOptimisticLockingFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.delete(Object)

delete

public void delete(java.lang.String entityName,
                   java.lang.Object entity)
            throws DataAccessException

Description copied from interface: HibernateOperations

Delete the given persistent instance.

Specified by:

delete in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the persistent instance to delete

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.delete(Object)

delete

public void delete(java.lang.String entityName,
                   java.lang.Object entity,
                   LockMode lockMode)
            throws DataAccessException

Description copied from interface: HibernateOperations

Delete the given persistent instance.

Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.

Specified by:

delete in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

entity - the persistent instance to delete

lockMode - the lock mode to obtain

Throws:

ObjectOptimisticLockingFailureException - if not found

DataAccessException - in case of Hibernate errors

See Also:

Session.delete(Object)

deleteAll

public void deleteAll(java.util.Collection<?> entities)
               throws DataAccessException

Description copied from interface: HibernateOperations

Delete all given persistent instances.

This can be combined with any of the find methods to delete by query in two lines of code.

Specified by:

deleteAll in interface HibernateOperations

Parameters:

entities - the persistent instances to delete

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.delete(Object)

flush

public void flush()
           throws DataAccessException

Description copied from interface: HibernateOperations

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.

Specified by:

flush in interface HibernateOperations

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.flush()

clear

public void clear()
           throws DataAccessException

Description copied from interface: HibernateOperations

Remove all objects from the Session cache, and cancel all pending saves, updates and deletes.

Specified by:

clear in interface HibernateOperations

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Session.clear()

find

public java.util.List<?> find(java.lang.String queryString,
                              java.lang.Object... values)
                       throws DataAccessException

Description copied from interface: HibernateOperations

Execute an HQL query, binding a number of values to "?" parameters in the query string.

Specified by:

find in interface HibernateOperations

Parameters:

queryString - a query expressed in Hibernate's query language

values - the values of the parameters

Returns:

a List containing the results of the query execution

Throws:

DataAccessException - in case of Hibernate errors

See Also:

SharedSessionContract.createQuery(java.lang.String)

findByNamedParam

public java.util.List<?> findByNamedParam(java.lang.String queryString,
                                          java.lang.String paramName,
                                          java.lang.Object value)
                                   throws DataAccessException

Description copied from interface: HibernateOperations

Execute an HQL query, binding one value to a ":" named parameter in the query string.

Specified by:

findByNamedParam in interface HibernateOperations

Parameters:

queryString - a query expressed in Hibernate's query language

paramName - the name of the parameter

value - the value of the parameter

Returns:

a List containing the results of the query execution

Throws:

DataAccessException - in case of Hibernate errors

See Also:

SharedSessionContract.getNamedQuery(String)

findByNamedParam

public java.util.List<?> findByNamedParam(java.lang.String queryString,
                                          java.lang.String[] paramNames,
                                          java.lang.Object[] values)
                                   throws DataAccessException

Description copied from interface: HibernateOperations

Execute an HQL query, binding a number of values to ":" named parameters in the query string.

Specified by:

findByNamedParam in interface HibernateOperations

Parameters:

queryString - a query expressed in Hibernate's query language

paramNames - the names of the parameters

values - the values of the parameters

Returns:

a List containing the results of the query execution

Throws:

DataAccessException - in case of Hibernate errors

See Also:

SharedSessionContract.getNamedQuery(String)

findByValueBean

public java.util.List<?> findByValueBean(java.lang.String queryString,
                                         java.lang.Object valueBean)
                                  throws DataAccessException

Description copied from interface: HibernateOperations

Execute an HQL query, binding the properties of the given bean to named parameters in the query string.

Specified by:

findByValueBean in interface HibernateOperations

Parameters:

queryString - a query expressed in Hibernate's query language

valueBean - the values of the parameters

Returns:

a List containing the results of the query execution

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Query.setProperties(java.lang.Object), SharedSessionContract.createQuery(java.lang.String)

findByNamedQuery

public java.util.List<?> findByNamedQuery(java.lang.String queryName,
                                          java.lang.Object... values)
                                   throws DataAccessException

Description copied from interface: HibernateOperations

Execute a named query binding a number of values to "?" parameters in the query string.

A named query is defined in a Hibernate mapping file.

Specified by:

findByNamedQuery in interface HibernateOperations

Parameters:

queryName - the name of a Hibernate query in a mapping file

values - the values of the parameters

Returns:

a List containing the results of the query execution

Throws:

DataAccessException - in case of Hibernate errors

See Also:

SharedSessionContract.getNamedQuery(String)

findByNamedQueryAndNamedParam

public java.util.List<?> findByNamedQueryAndNamedParam(java.lang.String queryName,
                                                       java.lang.String paramName,
                                                       java.lang.Object value)
                                                throws DataAccessException

Description copied from interface: HibernateOperations

Execute a named query, binding one value to a ":" named parameter in the query string.

A named query is defined in a Hibernate mapping file.

Specified by:

findByNamedQueryAndNamedParam in interface HibernateOperations

Parameters:

queryName - the name of a Hibernate query in a mapping file

paramName - the name of parameter

value - the value of the parameter

Returns:

a List containing the results of the query execution

Throws:

DataAccessException - in case of Hibernate errors

See Also:

SharedSessionContract.getNamedQuery(String)

findByNamedQueryAndNamedParam

public java.util.List<?> findByNamedQueryAndNamedParam(java.lang.String queryName,
                                                       java.lang.String[] paramNames,
                                                       java.lang.Object[] values)
                                                throws DataAccessException

Description copied from interface: HibernateOperations

Execute 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.

Specified by:

findByNamedQueryAndNamedParam in interface HibernateOperations

Parameters:

queryName - the name of a Hibernate query in a mapping file

paramNames - the names of the parameters

values - the values of the parameters

Returns:

a List containing the results of the query execution

Throws:

DataAccessException - in case of Hibernate errors

See Also:

SharedSessionContract.getNamedQuery(String)

findByNamedQueryAndValueBean

public java.util.List<?> findByNamedQueryAndValueBean(java.lang.String queryName,
                                                      java.lang.Object valueBean)
                                               throws DataAccessException

Description copied from interface: HibernateOperations

Execute 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.

Specified by:

findByNamedQueryAndValueBean in interface HibernateOperations

Parameters:

queryName - the name of a Hibernate query in a mapping file

valueBean - the values of the parameters

Returns:

a List containing the results of the query execution

Throws:

DataAccessException - in case of Hibernate errors

See Also:

Query.setProperties(java.lang.Object), SharedSessionContract.getNamedQuery(String)

findByCriteria

public java.util.List<?> findByCriteria(DetachedCriteria criteria)
                                 throws DataAccessException

Description copied from interface: HibernateOperations

Execute a query based on a given Hibernate criteria object.

Specified by:

findByCriteria in interface HibernateOperations

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:

DetachedCriteria.getExecutableCriteria(org.hibernate.Session)

findByCriteria

public java.util.List<?> findByCriteria(DetachedCriteria criteria,
                                        int firstResult,
                                        int maxResults)
                                 throws DataAccessException

Description copied from interface: HibernateOperations

Execute a query based on the given Hibernate criteria object.

Specified by:

findByCriteria in interface HibernateOperations

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:

DetachedCriteria.getExecutableCriteria(org.hibernate.Session), Criteria.setFirstResult(int), Criteria.setMaxResults(int)

findByExample

public <T> java.util.List<T> findByExample(T exampleEntity)
                                    throws DataAccessException

Description copied from interface: HibernateOperations

Execute a query based on the given example entity object.

Specified by:

findByExample in interface HibernateOperations

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:

Example.create(Object)

findByExample

public <T> java.util.List<T> findByExample(java.lang.String entityName,
                                           T exampleEntity)
                                    throws DataAccessException

Description copied from interface: HibernateOperations

Execute a query based on the given example entity object.

Specified by:

findByExample in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

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:

Example.create(Object)

findByExample

public <T> java.util.List<T> findByExample(T exampleEntity,
                                           int firstResult,
                                           int maxResults)
                                    throws DataAccessException

Description copied from interface: HibernateOperations

Execute a query based on a given example entity object.

Specified by:

findByExample in interface HibernateOperations

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:

Example.create(Object), Criteria.setFirstResult(int), Criteria.setMaxResults(int)

findByExample

public <T> java.util.List<T> findByExample(java.lang.String entityName,
                                           T exampleEntity,
                                           int firstResult,
                                           int maxResults)
                                    throws DataAccessException

Description copied from interface: HibernateOperations

Execute a query based on a given example entity object.

Specified by:

findByExample in interface HibernateOperations

Parameters:

entityName - the name of the persistent entity

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:

Example.create(Object), Criteria.setFirstResult(int), Criteria.setMaxResults(int)

iterate

public java.util.Iterator<?> iterate(java.lang.String queryString,
                                     java.lang.Object... values)
                              throws DataAccessException

Description copied from interface: HibernateOperations

Execute 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.

Specified by:

iterate in interface HibernateOperations

Parameters:

queryString - a query expressed in Hibernate's query language

values - the values of the parameters

Returns:

an Iterator containing 0 or more persistent instances

Throws:

DataAccessException - in case of Hibernate errors

See Also:

SharedSessionContract.createQuery(java.lang.String), Query.iterate()

closeIterator

public void closeIterator(java.util.Iterator<?> it)
                   throws DataAccessException

Description copied from interface: HibernateOperations

Immediately close an Iterator created by any of the various iterate(..) operations, instead of waiting until the session is closed or disconnected.

Specified by:

closeIterator in interface HibernateOperations

Parameters:

it - the Iterator to close

Throws:

DataAccessException - if the Iterator could not be closed

See Also:

Hibernate.close(java.util.Iterator)

bulkUpdate

public int bulkUpdate(java.lang.String queryString,
                      java.lang.Object... values)
               throws DataAccessException

Description copied from interface: HibernateOperations

Update/delete all objects according to the given query, binding a number of values to "?" parameters in the query string.

Specified by:

bulkUpdate in interface HibernateOperations

Parameters:

queryString - an update/delete query expressed in Hibernate's query language

values - the values of the parameters

Returns:

the number of instances updated/deleted

Throws:

DataAccessException - in case of Hibernate errors

See Also:

SharedSessionContract.createQuery(java.lang.String), Query.executeUpdate()

checkWriteOperationAllowed

protected void checkWriteOperationAllowed(Session session)
                                   throws InvalidDataAccessApiUsageException

Check whether write operations are allowed on the given Session.

Default implementation throws an InvalidDataAccessApiUsageException in case of FlushMode.MANUAL. Can be overridden in subclasses.

Parameters:

session - current Hibernate Session

Throws:

InvalidDataAccessApiUsageException - if write operations are not allowed

See Also:

setCheckWriteOperations(boolean), Session.getFlushMode(), FlushMode.MANUAL

prepareQuery

protected void prepareQuery(Query queryObject)

Prepare the given Query object, applying cache settings and/or a transaction timeout.

Parameters:

queryObject - the Query object to prepare

See Also:

setCacheQueries(boolean), setQueryCacheRegion(java.lang.String)

prepareCriteria

protected void prepareCriteria(Criteria criteria)

Prepare the given Criteria object, applying cache settings and/or a transaction timeout.

Parameters:

criteria - the Criteria object to prepare

See Also:

setCacheQueries(boolean), setQueryCacheRegion(java.lang.String)

applyNamedParameterToQuery

protected void applyNamedParameterToQuery(Query queryObject,
                                          java.lang.String paramName,
                                          java.lang.Object value)
                                   throws HibernateException

Apply the given name parameter to the given Query object.

Parameters:

queryObject - the Query object

paramName - the name of the parameter

value - the value of the parameter

Throws:

HibernateException - if thrown by the Query object