HibernateTemplate (Spring Framework 5.2.8.RELEASE API)

java.lang.Object
- org.springframework.orm.hibernate5.HibernateTemplate

All Implemented Interfaces:

InitializingBean, HibernateOperations
```
public class HibernateTemplate
extends 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 against the native Hibernate Session. Hence, for newly started projects, consider adopting the standard Hibernate style of coding against SessionFactory.getCurrentSession(). Alternatively, use execute(HibernateCallback) with Java 8 lambda code blocks against the callback-provided Session which results in elegant code as well, decoupled from the Hibernate Session lifecycle. The remaining operations on this HibernateTemplate are deprecated in the meantime and primarily exist as a migration helper for older Hibernate 3.x/4.x data access code in existing applications.

Since:

4.2

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

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

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`afterPropertiesSet()` Invoked by the containing `BeanFactory` after it has set all bean properties and satisfied `BeanFactoryAware`, `ApplicationContextAware` etc.
`protected void`	`applyNamedParameterToQuery(Query queryObject, String paramName, Object value)` Deprecated.
`int`	`bulkUpdate(String queryString, Object... values)` Deprecated.
`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(Iterator<?> it)` Deprecated.
`boolean`	`contains(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(Object entity)` Delete the given persistent instance.
`void`	`delete(Object entity, LockMode lockMode)` Delete the given persistent instance.
`void`	`delete(String entityName, Object entity)` Delete the given persistent instance.
`void`	`delete(String entityName, Object entity, LockMode lockMode)` Delete the given persistent instance.
`void`	`deleteAll(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(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(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`.
`List<?>`	`find(String queryString, Object... values)` Deprecated.
`List<?>`	`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.
`List<?>`	`findByNamedParam(String queryString, String paramName, Object value)` Deprecated.
`List<?>`	`findByNamedQuery(String queryName, Object... values)` Deprecated.
`List<?>`	`findByNamedQueryAndNamedParam(String queryName, String[] paramNames, Object[] values)` Deprecated.
`List<?>`	`findByNamedQueryAndNamedParam(String queryName, String paramName, Object value)` Deprecated.
`List<?>`	`findByNamedQueryAndValueBean(String queryName, Object valueBean)` Deprecated.
`List<?>`	`findByValueBean(String queryString, Object valueBean)` Deprecated.
`void`	`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, or `null` 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, or `null` if not found.
`Object`	`get(String entityName, Serializable id)` Return the persistent instance of the given entity class with the given identifier, or `null` if not found.
`Object`	`get(String entityName, 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.
`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.
`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(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.
`Iterator<?>`	`iterate(String queryString, Object... values)` Deprecated.
`<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.
`Object`	`load(String entityName, Serializable id)` Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.
`Object`	`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>`	`loadAll(Class<T> entityClass)` Return all persistent instances of the given entity class.
`void`	`lock(Object entity, LockMode lockMode)` Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.
`void`	`lock(String entityName, 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(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.
`protected SessionFactory`	`obtainSessionFactory()` Obtain the SessionFactory for actual use.
`void`	`persist(Object entity)` Persist the given transient instance.
`void`	`persist(String entityName, 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(Object entity)` Re-read the state of the given persistent instance.
`void`	`refresh(Object entity, LockMode lockMode)` 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.
`Serializable`	`save(Object entity)` Persist the given transient instance.
`Serializable`	`save(String entityName, Object entity)` 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`	`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(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(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(Object entity)` Update the given persistent instance, associating it with the current Hibernate `Session`.
`void`	`update(Object entity, LockMode lockMode)` Update the given persistent instance, associating it with the current Hibernate `Session`.
`void`	`update(String entityName, Object entity)` Update the given persistent instance, associating it with the current Hibernate `Session`.
`void`	`update(String entityName, 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(@Nullable
                              SessionFactory sessionFactory)
```
    Set the Hibernate SessionFactory that should be used to create Hibernate Sessions.
  - getSessionFactory
```
@Nullable
public SessionFactory getSessionFactory()
```
    Return the Hibernate SessionFactory that should be used to create Hibernate Sessions.
  - obtainSessionFactory
```
protected final SessionFactory obtainSessionFactory()
```
    Obtain the SessionFactory for actual use.
    
    Returns:
    
    the SessionFactory (never null)
    
    Throws:
    
    IllegalStateException - in case of no SessionFactory set
    
    Since:
    
    5.0
  - setFilterNames
```
public void setFilterNames(@Nullable
                           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(Session), Session.enableFilter(String)
  - getFilterNames
```
@Nullable
public 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(@Nullable
                                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
```
@Nullable
public 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 the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.
    This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.
    
    Specified by:
    
    afterPropertiesSet in interface InitializingBean
  - execute
```
@Nullable
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
```
@Nullable
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
```
@Nullable
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:
    
    SharedSessionContract.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
```
@Nullable
public <T> T get(Class<T> entityClass,
                           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, 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, Serializable)
  - get
```
@Nullable
public <T> T get(Class<T> entityClass,
                           Serializable id,
                           @Nullable
                           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, 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, Serializable, LockMode)
  - get
```
@Nullable
public Object get(String entityName,
                            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, 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, Serializable)
  - get
```
@Nullable
public Object get(String entityName,
                            Serializable id,
                            @Nullable
                            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, 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, Serializable, LockMode)
  - load
```
public <T> T load(Class<T> entityClass,
                  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, 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, Serializable)
  - load
```
public <T> T load(Class<T> entityClass,
                  Serializable id,
                  @Nullable
                  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, 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, Serializable)
  - load
```
public Object load(String entityName,
                   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, 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, Serializable)
  - load
```
public Object load(String entityName,
                   Serializable id,
                   @Nullable
                   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, 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, Serializable)
  - loadAll
```
public <T> List<T> loadAll(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(Object entity,
                 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, 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, Serializable)
  - refresh
```
public void refresh(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(Object entity,
                    @Nullable
                    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, LockMode)
  - contains
```
public boolean contains(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.String, java.lang.Object)
  - evict
```
public void evict(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(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(String filterName)
                    throws 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:
    
    IllegalStateException - if we are not running within a transactional Session (in which case this operation does not make sense)
  - lock
```
public void lock(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, LockMode)
  - lock
```
public void lock(String entityName,
                 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, LockMode)
  - save
```
public Serializable save(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 Serializable save(String entityName,
                         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(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(Object entity,
                   @Nullable
                   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(String entityName,
                   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(String entityName,
                   Object entity,
                   @Nullable
                   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(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(String entityName,
                         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(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, ReplicationMode)
  - replicate
```
public void replicate(String entityName,
                      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, ReplicationMode)
  - persist
```
public void persist(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(String entityName,
                    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(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(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(Object entity,
                   @Nullable
                   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(String entityName,
                   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(String entityName,
                   Object entity,
                   @Nullable
                   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(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()
  - findByCriteria
```
public 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 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> 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> List<T> findByExample(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> 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> List<T> findByExample(@Nullable
                                 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)
  - find
```
@Deprecated
public List<?> find(String queryString,
                                @Nullable
                                Object... values)
                         throws DataAccessException
```
    Deprecated.
    
    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:
    
    Session.createQuery(java.lang.String, java.lang.Class<T>)
  - findByNamedParam
```
@Deprecated
public List<?> findByNamedParam(String queryString,
                                            String paramName,
                                            Object value)
                                     throws DataAccessException
```
    Deprecated.
    
    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
```
@Deprecated
public List<?> findByNamedParam(String queryString,
                                            String[] paramNames,
                                            Object[] values)
                                     throws DataAccessException
```
    Deprecated.
    
    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
```
@Deprecated
public List<?> findByValueBean(String queryString,
                                           Object valueBean)
                                    throws DataAccessException
```
    Deprecated.
    
    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), Session.createQuery(java.lang.String, java.lang.Class<T>)
  - findByNamedQuery
```
@Deprecated
public List<?> findByNamedQuery(String queryName,
                                            @Nullable
                                            Object... values)
                                     throws DataAccessException
```
    Deprecated.
    
    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
```
@Deprecated
public List<?> findByNamedQueryAndNamedParam(String queryName,
                                                         String paramName,
                                                         Object value)
                                                  throws DataAccessException
```
    Deprecated.
    
    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
```
@Deprecated
public List<?> findByNamedQueryAndNamedParam(String queryName,
                                                         @Nullable
                                                         String[] paramNames,
                                                         @Nullable
                                                         Object[] values)
                                                  throws DataAccessException
```
    Deprecated.
    
    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
```
@Deprecated
public List<?> findByNamedQueryAndValueBean(String queryName,
                                                        Object valueBean)
                                                 throws DataAccessException
```
    Deprecated.
    
    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)
  - iterate
```
@Deprecated
public Iterator<?> iterate(String queryString,
                                       @Nullable
                                       Object... values)
                                throws DataAccessException
```
    Deprecated.
    
    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:
    
    Session.createQuery(java.lang.String, java.lang.Class<T>), Query.iterate()
  - closeIterator
```
@Deprecated
public void closeIterator(Iterator<?> it)
                               throws DataAccessException
```
    Deprecated.
    
    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
```
@Deprecated
public int bulkUpdate(String queryString,
                                  @Nullable
                                  Object... values)
                           throws DataAccessException
```
    Deprecated.
    
    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:
    
    Session.createQuery(java.lang.String, java.lang.Class<T>), 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
  - 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)
  - 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)
  - applyNamedParameterToQuery
```
@Deprecated
protected void applyNamedParameterToQuery(Query queryObject,
                                                      String paramName,
                                                      Object value)
                                               throws HibernateException
```
    Deprecated.
    
    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

Class HibernateTemplate

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

logger

Constructor Detail

HibernateTemplate

HibernateTemplate

Method Detail

setSessionFactory

getSessionFactory

obtainSessionFactory

setFilterNames

getFilterNames

setExposeNativeSession

isExposeNativeSession

setCheckWriteOperations

isCheckWriteOperations

setCacheQueries

isCacheQueries

setQueryCacheRegion

getQueryCacheRegion

setFetchSize

getFetchSize

setMaxResults

getMaxResults

afterPropertiesSet

execute

executeWithNativeSession

doExecute

createSessionProxy

enableFilters

disableFilters

get

get

get

get

load

load

load

load

loadAll

load

refresh

refresh

contains

evict

initialize

enableFilter

lock

lock

save

save

update

update

update

update

saveOrUpdate

saveOrUpdate

replicate

replicate

persist

persist

merge

merge

delete

delete

delete

delete

deleteAll

flush

clear

findByCriteria

findByCriteria

findByExample

findByExample

findByExample

findByExample