Java Doc for HibernateOperations.java in  » J2EE » spring-framework-2.5 » org » springframework » orm » hibernate3 » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » J2EE » spring framework 2.5 » org.springframework.orm.hibernate3 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


org.springframework.orm.hibernate3.HibernateOperations

All known Subclasses:   org.springframework.orm.hibernate3.HibernateTemplate,
HibernateOperations
public interface HibernateOperations (Code)
Interface that specifies a basic set of Hibernate operations, implemented by HibernateTemplate . Not often used, but a useful option to enhance testability, as it can easily be mocked or stubbed.

Defines HibernateTemplate's data access methods that mirror various org.hibernate.Session methods. Users are strongly encouraged to read the Hibernate Session javadocs for details on the semantics of those methods.

Note that operations that return an java.util.Iterator (i.e. iterate(..)) are supposed to be used within Spring-driven or JTA-driven transactions (with HibernateTransactionManager , org.springframework.transaction.jta.JtaTransactionManager , or EJB CMT). Else, the Iterator won't be able to read results from its java.sql.ResultSet anymore, as the underlying Hibernate Session will already have been closed.

Note that lazy loading will just work with an open Hibernate Session, either within a transaction or within org.springframework.orm.hibernate3.support.OpenSessionInViewFilter / org.springframework.orm.hibernate3.support.OpenSessionInViewInterceptor . Furthermore, some operations just make sense within transactions, for example: contains, evict, lock, flush, clear.
author:
   Juergen Hoeller
since:
   1.2
See Also:   HibernateTemplate
See Also:   org.hibernate.Session
See Also:   HibernateTransactionManager
See Also:   org.springframework.transaction.jta.JtaTransactionManager
See Also:   org.springframework.orm.hibernate3.support.OpenSessionInViewFilter
See Also:   org.springframework.orm.hibernate3.support.OpenSessionInViewInterceptor





Method Summary
 intbulkUpdate(String queryString)
     Update/delete all objects according to the given query.
 intbulkUpdate(String queryString, Object value)
     Update/delete all objects according to the given query, binding one value to a "?" parameter in the query string.
 intbulkUpdate(String queryString, Object[] values)
     Update/delete all objects according to the given query, binding a number of values to "?" parameters in the query string.
 voidclear()
     Remove all objects from the org.hibernate.Session cache, and cancel all pending saves, updates and deletes.
 voidcloseIterator(Iterator it)
     Immediately close an Iterator created by any of the various iterate(..) operations, instead of waiting until the session is closed or disconnected.
 booleancontains(Object entity)
     Check whether the given object is in the Session cache.
 voiddelete(Object entity)
     Delete the given persistent instance.
 voiddelete(Object entity, LockMode lockMode)
     Delete the given persistent instance.
 voiddeleteAll(Collection entities)
     Delete all given persistent instances.
 FilterenableFilter(String filterName)
     Return an enabled Hibernate Filter for the given filter name.
 voidevict(Object entity)
     Remove the given object from the org.hibernate.Session cache.
 Objectexecute(HibernateCallback action)
     Execute the action specified by the given action object within a org.hibernate.Session .

Application exceptions thrown by the action object get propagated to the caller (can only be unchecked).

 ListexecuteFind(HibernateCallback action)
     Execute the specified action assuming that the result object is a List .
 Listfind(String queryString)
     Execute an HQL query.
 Listfind(String queryString, Object value)
     Execute an HQL query, binding one value to a "?" parameter in the query string.
 Listfind(String queryString, Object[] values)
     Execute an HQL query, binding a number of values to "?" parameters in the query string.
 ListfindByCriteria(DetachedCriteria criteria)
     Execute a query based on a given Hibernate criteria object.
 ListfindByCriteria(DetachedCriteria criteria, int firstResult, int maxResults)
     Execute a query based on the given Hibernate criteria object.
 ListfindByExample(Object exampleEntity)
     Execute a query based on the given example entity object.
 ListfindByExample(String entityName, Object exampleEntity)
     Execute a query based on the given example entity object.
 ListfindByExample(Object exampleEntity, int firstResult, int maxResults)
     Execute a query based on a given example entity object.
 ListfindByExample(String entityName, Object exampleEntity, int firstResult, int maxResults)
     Execute a query based on a given example entity object.
 ListfindByNamedParam(String queryString, String paramName, Object value)
     Execute an HQL query, binding one value to a ":" named parameter in the query string.
 ListfindByNamedParam(String queryString, String[] paramNames, Object[] values)
     Execute an HQL query, binding a number of values to ":" named parameters in the query string.
 ListfindByNamedQuery(String queryName)
     Execute a named query.
 ListfindByNamedQuery(String queryName, Object value)
     Execute a named query, binding one value to a "?" parameter in the query string.
 ListfindByNamedQuery(String queryName, Object[] values)
     Execute a named query binding a number of values to "?" parameters in the query string.
 ListfindByNamedQueryAndNamedParam(String queryName, String paramName, Object value)
     Execute a named query, binding one value to a ":" named parameter in the query string.
 ListfindByNamedQueryAndNamedParam(String queryName, String[] paramNames, Object[] values)
     Execute a named query, binding a number of values to ":" named parameters in the query string.
 ListfindByNamedQueryAndValueBean(String queryName, Object valueBean)
     Execute a named query, binding the properties of the given bean to ":" named parameters in the query string.
 ListfindByValueBean(String queryString, Object valueBean)
     Execute an HQL query, binding the properties of the given bean to named parameters in the query string.
 voidflush()
     Flush all pending saves, updates and deletes to the database.
 Objectget(Class entityClass, Serializable id)
     Return the persistent instance of the given entity class with the given identifier, or null if not found.
 Objectget(Class entityClass, Serializable id, LockMode lockMode)
     Return the persistent instance of the given entity class with the given identifier, or null if not found.
 Objectget(String entityName, Serializable id)
     Return the persistent instance of the given entity class with the given identifier, or null if not found.
 Objectget(String entityName, Serializable id, LockMode lockMode)
     Return the persistent instance of the given entity class with the given identifier, or null if not found.
 voidinitialize(Object proxy)
     Force initialization of a Hibernate proxy or persistent collection.
 Iteratoriterate(String queryString)
     Execute a query for persistent instances.

Returns the results as an Iterator .

 Iteratoriterate(String queryString, Object value)
     Execute a query for persistent instances, binding one value to a "?" parameter in the query string.

Returns the results as an Iterator .

 Iteratoriterate(String queryString, Object[] values)
     Execute a query for persistent instances, binding a number of values to "?" parameters in the query string.

Returns the results as an Iterator .

 Objectload(Class entityClass, Serializable id)
     Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.
 Objectload(Class entityClass, Serializable id, LockMode lockMode)
     Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.
 Objectload(String entityName, Serializable id)
     Return the persistent instance of the given entity class with the given identifier, throwing an exception if not found.
 Objectload(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.
 voidload(Object entity, Serializable id)
     Load the persistent instance with the given identifier into the given object, throwing an exception if not found.
 ListloadAll(Class entityClass)
     Return all persistent instances of the given entity class. Note: Use queries or criteria for retrieving a specific subset.
 voidlock(Object entity, LockMode lockMode)
     Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.
 voidlock(String entityName, Object entity, LockMode lockMode)
     Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.
 Objectmerge(Object entity)
     Copy the state of the given object onto the persistent object with the same identifier.
 Objectmerge(String entityName, Object entity)
     Copy the state of the given object onto the persistent object with the same identifier.
 voidpersist(Object entity)
     Persist the given transient instance.
 voidpersist(String entityName, Object entity)
     Persist the given transient instance.
 voidrefresh(Object entity)
     Re-read the state of the given persistent instance.
 voidrefresh(Object entity, LockMode lockMode)
     Re-read the state of the given persistent instance.
 voidreplicate(Object entity, ReplicationMode replicationMode)
     Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.
 voidreplicate(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.
 Serializablesave(Object entity)
     Persist the given transient instance.
 Serializablesave(String entityName, Object entity)
     Persist the given transient instance.
 voidsaveOrUpdate(Object entity)
     Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?).
 voidsaveOrUpdate(String entityName, Object entity)
     Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?).
 voidsaveOrUpdateAll(Collection entities)
     Save or update all given persistent instances, according to its id (matching the configured "unsaved-value"?).
 voidupdate(Object entity)
     Update the given persistent instance, associating it with the current Hibernate org.hibernate.Session .
 voidupdate(Object entity, LockMode lockMode)
     Update the given persistent instance, associating it with the current Hibernate org.hibernate.Session .
 voidupdate(String entityName, Object entity)
     Update the given persistent instance, associating it with the current Hibernate org.hibernate.Session .
 voidupdate(String entityName, Object entity, LockMode lockMode)
     Update the given persistent instance, associating it with the current Hibernate org.hibernate.Session .



Method Detail
bulkUpdate
int bulkUpdate(String queryString) throws DataAccessException(Code)
Update/delete all objects according to the given query.
Parameters:
  queryString - an update/delete query expressed in Hibernate's query language the number of instances updated/deleted
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery
See Also:   org.hibernate.Query.executeUpdate



bulkUpdate
int bulkUpdate(String queryString, Object value) throws DataAccessException(Code)
Update/delete all objects according to the given query, binding one value to a "?" parameter in the query string.
Parameters:
  queryString - an update/delete query expressed in Hibernate's query language
Parameters:
  value - the value of the parameter the number of instances updated/deleted
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery
See Also:   org.hibernate.Query.executeUpdate



bulkUpdate
int bulkUpdate(String queryString, Object[] values) throws DataAccessException(Code)
Update/delete all objects according to the given query, binding a number of values to "?" parameters in the query string.
Parameters:
  queryString - an update/delete query expressed in Hibernate's query language
Parameters:
  values - the values of the parameters the number of instances updated/deleted
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery
See Also:   org.hibernate.Query.executeUpdate



clear
void clear() throws DataAccessException(Code)
Remove all objects from the org.hibernate.Session cache, and cancel all pending saves, updates and deletes.
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.clear



closeIterator
void closeIterator(Iterator it) throws DataAccessException(Code)
Immediately close an Iterator created by any of the various iterate(..) operations, instead of waiting until the session is closed or disconnected.
Parameters:
  it - the Iterator to close
throws:
  DataAccessException - if the Iterator could not be closed
See Also:   org.hibernate.Hibernate.close



contains
boolean contains(Object entity) throws DataAccessException(Code)
Check whether the given object is in the Session cache.
Parameters:
  entity - the persistence instance to check whether the given object is in the Session cache
throws:
  org.springframework.dao.DataAccessException - if there is a Hibernate error
See Also:   org.hibernate.Session.contains



delete
void delete(Object entity) throws DataAccessException(Code)
Delete the given persistent instance.
Parameters:
  entity - the persistent instance to delete
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.delete(Object)



delete
void delete(Object entity, LockMode lockMode) throws DataAccessException(Code)
Delete the given persistent instance.

Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.
Parameters:
  entity - the persistent instance to delete
Parameters:
  lockMode - the lock mode to obtain
throws:
  org.springframework.orm.ObjectOptimisticLockingFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.delete(Object)




deleteAll
void deleteAll(Collection entities) throws DataAccessException(Code)
Delete all given persistent instances.

This can be combined with any of the find methods to delete by query in two lines of code.
Parameters:
  entities - the persistent instances to delete
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.delete(Object)




enableFilter
Filter enableFilter(String filterName) throws IllegalStateException(Code)
Return an enabled Hibernate Filter for the given filter name. The returned Filter instance can be used to set filter parameters.
Parameters:
  filterName - the name of the filter the enabled Hibernate Filter (either alreadyenabled or enabled on the fly by this operation)
throws:
  IllegalStateException - if we are not running within atransactional Session (in which case this operation does not make sense)



evict
void evict(Object entity) throws DataAccessException(Code)
Remove the given object from the org.hibernate.Session cache.
Parameters:
  entity - the persistent instance to evict
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.evict



execute
Object execute(HibernateCallback action) throws DataAccessException(Code)
Execute the action specified by the given action object within a org.hibernate.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.
Parameters:
  action - callback object that specifies the Hibernate action a result object returned by the action, or null
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   HibernateTransactionManager
See Also:   org.springframework.dao
See Also:   org.springframework.transaction
See Also:   org.hibernate.Session




executeFind
List executeFind(HibernateCallback action) throws DataAccessException(Code)
Execute the specified action assuming that the result object is a List .

This is a convenience method for executing Hibernate find calls or queries within an action.
Parameters:
  action - calback object that specifies the Hibernate action a List result returned by the action, or null
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors




find
List find(String queryString) throws DataAccessException(Code)
Execute an HQL query.
Parameters:
  queryString - a query expressed in Hibernate's query language a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery



find
List find(String queryString, Object value) throws DataAccessException(Code)
Execute an HQL query, binding one value to a "?" parameter in the query string.
Parameters:
  queryString - a query expressed in Hibernate's query language
Parameters:
  value - the value of the parameter a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery



find
List find(String queryString, Object[] values) throws DataAccessException(Code)
Execute an HQL query, binding a number of values to "?" parameters in the query string.
Parameters:
  queryString - a query expressed in Hibernate's query language
Parameters:
  values - the values of the parameters a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery



findByCriteria
List findByCriteria(DetachedCriteria criteria) throws DataAccessException(Code)
Execute a query based on a given Hibernate criteria object.
Parameters:
  criteria - the detached Hibernate criteria object,which can for example be held in an instance variable of a DAO a List containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.criterion.DetachedCriteria.getExecutableCriteria(org.hibernate.Session)



findByCriteria
List findByCriteria(DetachedCriteria criteria, int firstResult, int maxResults) throws DataAccessException(Code)
Execute a query based on the given Hibernate criteria object.
Parameters:
  criteria - the detached Hibernate criteria object,which can for example be held in an instance variable of a DAO
Parameters:
  firstResult - the index of the first result object to be retrieved(numbered from 0)
Parameters:
  maxResults - the maximum number of result objects to retrieve(or <=0 for no limit) a List containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.criterion.DetachedCriteria.getExecutableCriteria(org.hibernate.Session)
See Also:   org.hibernate.Criteria.setFirstResult(int)
See Also:   org.hibernate.Criteria.setMaxResults(int)



findByExample
List findByExample(Object exampleEntity) throws DataAccessException(Code)
Execute a query based on the given example entity object.
Parameters:
  exampleEntity - an instance of the desired entity,serving as example for "query-by-example" a List containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.criterion.Example.create(Object)



findByExample
List findByExample(String entityName, Object exampleEntity) throws DataAccessException(Code)
Execute a query based on the given example entity object.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  exampleEntity - an instance of the desired entity,serving as example for "query-by-example" a List containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.criterion.Example.create(Object)



findByExample
List findByExample(Object exampleEntity, int firstResult, int maxResults) throws DataAccessException(Code)
Execute a query based on a given example entity object.
Parameters:
  exampleEntity - an instance of the desired entity,serving as example for "query-by-example"
Parameters:
  firstResult - the index of the first result object to be retrieved(numbered from 0)
Parameters:
  maxResults - the maximum number of result objects to retrieve(or <=0 for no limit) a List containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.criterion.Example.create(Object)
See Also:   org.hibernate.Criteria.setFirstResult(int)
See Also:   org.hibernate.Criteria.setMaxResults(int)



findByExample
List findByExample(String entityName, Object exampleEntity, int firstResult, int maxResults) throws DataAccessException(Code)
Execute a query based on a given example entity object.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  exampleEntity - an instance of the desired entity,serving as example for "query-by-example"
Parameters:
  firstResult - the index of the first result object to be retrieved(numbered from 0)
Parameters:
  maxResults - the maximum number of result objects to retrieve(or <=0 for no limit) a List containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.criterion.Example.create(Object)
See Also:   org.hibernate.Criteria.setFirstResult(int)
See Also:   org.hibernate.Criteria.setMaxResults(int)



findByNamedParam
List findByNamedParam(String queryString, String paramName, Object value) throws DataAccessException(Code)
Execute an HQL query, binding one value to a ":" named parameter in the query string.
Parameters:
  queryString - a query expressed in Hibernate's query language
Parameters:
  paramName - the name of the parameter
Parameters:
  value - the value of the parameter a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.getNamedQuery(String)



findByNamedParam
List findByNamedParam(String queryString, String[] paramNames, Object[] values) throws DataAccessException(Code)
Execute an HQL query, binding a number of values to ":" named parameters in the query string.
Parameters:
  queryString - a query expressed in Hibernate's query language
Parameters:
  paramNames - the names of the parameters
Parameters:
  values - the values of the parameters a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.getNamedQuery(String)



findByNamedQuery
List findByNamedQuery(String queryName) throws DataAccessException(Code)
Execute a named query.

A named query is defined in a Hibernate mapping file.
Parameters:
  queryName - the name of a Hibernate query in a mapping file a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.getNamedQuery(String)




findByNamedQuery
List findByNamedQuery(String queryName, Object value) throws DataAccessException(Code)
Execute a named query, binding one value to a "?" parameter in the query string.

A named query is defined in a Hibernate mapping file.
Parameters:
  queryName - the name of a Hibernate query in a mapping file
Parameters:
  value - the value of the parameter a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.getNamedQuery(String)




findByNamedQuery
List findByNamedQuery(String queryName, Object[] values) throws DataAccessException(Code)
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.
Parameters:
  queryName - the name of a Hibernate query in a mapping file
Parameters:
  values - the values of the parameters a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.getNamedQuery(String)




findByNamedQueryAndNamedParam
List findByNamedQueryAndNamedParam(String queryName, String paramName, Object value) throws DataAccessException(Code)
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.
Parameters:
  queryName - the name of a Hibernate query in a mapping file
Parameters:
  paramName - the name of parameter
Parameters:
  value - the value of the parameter a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.getNamedQuery(String)




findByNamedQueryAndNamedParam
List findByNamedQueryAndNamedParam(String queryName, String[] paramNames, Object[] values) throws DataAccessException(Code)
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.
Parameters:
  queryName - the name of a Hibernate query in a mapping file
Parameters:
  paramNames - the names of the parameters
Parameters:
  values - the values of the parameters a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.getNamedQuery(String)




findByNamedQueryAndValueBean
List findByNamedQueryAndValueBean(String queryName, Object valueBean) throws DataAccessException(Code)
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.
Parameters:
  queryName - the name of a Hibernate query in a mapping file
Parameters:
  valueBean - the values of the parameters a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Query.setProperties
See Also:   org.hibernate.Session.getNamedQuery(String)




findByValueBean
List findByValueBean(String queryString, Object valueBean) throws DataAccessException(Code)
Execute an HQL query, binding the properties of the given bean to named parameters in the query string.
Parameters:
  queryString - a query expressed in Hibernate's query language
Parameters:
  valueBean - the values of the parameters a List containing the results of the query execution
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Query.setProperties
See Also:   org.hibernate.Session.createQuery



flush
void flush() throws DataAccessException(Code)
Flush all pending saves, updates and deletes to the database.

Only invoke this for selective eager flushing, for example when JDBC code needs to see certain changes within the same transaction. Else, it is preferable to rely on auto-flushing at transaction completion.
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.flush




get
Object get(Class entityClass, Serializable id) throws DataAccessException(Code)
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 org.hibernate.Session.get(Classjava.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.
Parameters:
  entityClass - a persistent class
Parameters:
  id - the identifier of the persistent instance the persistent instance, or null if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.get(Classjava.io.Serializable)




get
Object get(Class entityClass, Serializable id, LockMode lockMode) throws DataAccessException(Code)
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 org.hibernate.Session.get(Classjava.io.SerializableLockMode) for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.
Parameters:
  entityClass - a persistent class
Parameters:
  id - the identifier of the persistent instance
Parameters:
  lockMode - the lock mode to obtain the persistent instance, or null if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.get(Classjava.io.Serializableorg.hibernate.LockMode)




get
Object get(String entityName, Serializable id) throws DataAccessException(Code)
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 org.hibernate.Session.get(Stringjava.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.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  id - the identifier of the persistent instance the persistent instance, or null if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.get(Classjava.io.Serializable)




get
Object get(String entityName, Serializable id, LockMode lockMode) throws DataAccessException(Code)
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 org.hibernate.Session.get(Stringjava.io.SerializableLockMode) for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  id - the identifier of the persistent instance
Parameters:
  lockMode - the lock mode to obtain the persistent instance, or null if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.get(Classjava.io.Serializableorg.hibernate.LockMode)




initialize
void initialize(Object proxy) throws DataAccessException(Code)
Force initialization of a Hibernate proxy or persistent collection.
Parameters:
  proxy - a proxy for a persistent object or a persistent collection
throws:
  DataAccessException - if we can't initialize the proxy, for examplebecause it is not associated with an active Session
See Also:   org.hibernate.Hibernate.initialize



iterate
Iterator iterate(String queryString) throws DataAccessException(Code)
Execute a query for persistent instances.

Returns the results as an Iterator . Entities returned are initialized on demand. See the Hibernate API documentation for details.
Parameters:
  queryString - a query expressed in Hibernate's query language an Iterator containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery
See Also:   org.hibernate.Query.iterate




iterate
Iterator iterate(String queryString, Object value) throws DataAccessException(Code)
Execute a query for persistent instances, binding one value to a "?" parameter in the query string.

Returns the results as an Iterator . Entities returned are initialized on demand. See the Hibernate API documentation for details.
Parameters:
  queryString - a query expressed in Hibernate's query language
Parameters:
  value - the value of the parameter an Iterator containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery
See Also:   org.hibernate.Query.iterate




iterate
Iterator iterate(String queryString, Object[] values) throws DataAccessException(Code)
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.
Parameters:
  queryString - a query expressed in Hibernate's query language
Parameters:
  values - the values of the parameters an Iterator containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.createQuery
See Also:   org.hibernate.Query.iterate




load
Object load(Class entityClass, Serializable id) throws DataAccessException(Code)
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 org.hibernate.Session.load(Classjava.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.
Parameters:
  entityClass - a persistent class
Parameters:
  id - the identifier of the persistent instance the persistent instance
throws:
  org.springframework.orm.ObjectRetrievalFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.load(Classjava.io.Serializable)




load
Object load(Class entityClass, Serializable id, LockMode lockMode) throws DataAccessException(Code)
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 org.hibernate.Session.load(Classjava.io.SerializableLockMode) for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.
Parameters:
  entityClass - a persistent class
Parameters:
  id - the identifier of the persistent instance
Parameters:
  lockMode - the lock mode to obtain the persistent instance
throws:
  org.springframework.orm.ObjectRetrievalFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.load(Classjava.io.Serializable)




load
Object load(String entityName, Serializable id) throws DataAccessException(Code)
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 org.hibernate.Session.load(Stringjava.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.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  id - the identifier of the persistent instance the persistent instance
throws:
  org.springframework.orm.ObjectRetrievalFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.load(Classjava.io.Serializable)




load
Object load(String entityName, Serializable id, LockMode lockMode) throws DataAccessException(Code)
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 org.hibernate.Session.load(Stringjava.io.SerializableLockMode) for convenience. For an explanation of the exact semantics of this method, please do refer to the Hibernate API documentation in the first instance.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  id - the identifier of the persistent instance
Parameters:
  lockMode - the lock mode to obtain the persistent instance
throws:
  org.springframework.orm.ObjectRetrievalFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.load(Classjava.io.Serializable)




load
void load(Object entity, Serializable id) throws DataAccessException(Code)
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 org.hibernate.Session.load(Objectjava.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.
Parameters:
  entity - the object (of the target class) to load into
Parameters:
  id - the identifier of the persistent instance
throws:
  org.springframework.orm.ObjectRetrievalFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.load(Objectjava.io.Serializable)




loadAll
List loadAll(Class entityClass) throws DataAccessException(Code)
Return all persistent instances of the given entity class. Note: Use queries or criteria for retrieving a specific subset.
Parameters:
  entityClass - a persistent class a List containing 0 or more persistent instances
throws:
  org.springframework.dao.DataAccessException - if there is a Hibernate error
See Also:   org.hibernate.Session.createCriteria



lock
void lock(Object entity, LockMode lockMode) throws DataAccessException(Code)
Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.
Parameters:
  entity - the persistent instance to lock
Parameters:
  lockMode - the lock mode to obtain
throws:
  org.springframework.orm.ObjectOptimisticLockingFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.lock(Objectorg.hibernate.LockMode)



lock
void lock(String entityName, Object entity, LockMode lockMode) throws DataAccessException(Code)
Obtain the specified lock level upon the given object, implicitly checking whether the corresponding database entry still exists.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  entity - the persistent instance to lock
Parameters:
  lockMode - the lock mode to obtain
throws:
  org.springframework.orm.ObjectOptimisticLockingFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.lock(StringObjectorg.hibernate.LockMode)



merge
Object merge(Object entity) throws DataAccessException(Code)
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.
Parameters:
  entity - the object to merge with the corresponding persistence instance the updated, registered persistent instance
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.merge(Object)
See Also:   HibernateOperations.saveOrUpdate
See Also:   org.springframework.orm.hibernate3.support.IdTransferringMergeEventListener




merge
Object merge(String entityName, Object entity) throws DataAccessException(Code)
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 org.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.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  entity - the object to merge with the corresponding persistence instance the updated, registered persistent instance
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.merge(StringObject)
See Also:   HibernateOperations.saveOrUpdate




persist
void persist(Object entity) throws DataAccessException(Code)
Persist the given transient instance. Follows JSR-220 semantics.

Similar to save, associating the given object with the current Hibernate org.hibernate.Session .
Parameters:
  entity - the persistent instance to persist
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.persist(Object)
See Also:   HibernateOperations.save




persist
void persist(String entityName, Object entity) throws DataAccessException(Code)
Persist the given transient instance. Follows JSR-220 semantics.

Similar to save, associating the given object with the current Hibernate org.hibernate.Session .
Parameters:
  entityName - the name of the persistent entity
Parameters:
  entity - the persistent instance to persist
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.persist(StringObject)
See Also:   HibernateOperations.save




refresh
void refresh(Object entity) throws DataAccessException(Code)
Re-read the state of the given persistent instance.
Parameters:
  entity - the persistent instance to re-read
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.refresh(Object)



refresh
void refresh(Object entity, LockMode lockMode) throws DataAccessException(Code)
Re-read the state of the given persistent instance. Obtains the specified lock mode for the instance.
Parameters:
  entity - the persistent instance to re-read
Parameters:
  lockMode - the lock mode to obtain
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.refresh(Objectorg.hibernate.LockMode)



replicate
void replicate(Object entity, ReplicationMode replicationMode) throws DataAccessException(Code)
Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.
Parameters:
  entity - the persistent object to replicate
Parameters:
  replicationMode - the Hibernate ReplicationMode
throws:
  DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.replicate(Objectorg.hibernate.ReplicationMode)



replicate
void replicate(String entityName, Object entity, ReplicationMode replicationMode) throws DataAccessException(Code)
Persist the state of the given detached instance according to the given replication mode, reusing the current identifier value.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  entity - the persistent object to replicate
Parameters:
  replicationMode - the Hibernate ReplicationMode
throws:
  DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.replicate(StringObjectorg.hibernate.ReplicationMode)



save
Serializable save(Object entity) throws DataAccessException(Code)
Persist the given transient instance.
Parameters:
  entity - the transient instance to persist the generated identifier
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.save(Object)



save
Serializable save(String entityName, Object entity) throws DataAccessException(Code)
Persist the given transient instance.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  entity - the transient instance to persist the generated identifier
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.save(StringObject)



saveOrUpdate
void saveOrUpdate(Object entity) throws DataAccessException(Code)
Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?). Associates the instance with the current Hibernate org.hibernate.Session .
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:   org.hibernate.Session.saveOrUpdate(Object)



saveOrUpdate
void saveOrUpdate(String entityName, Object entity) throws DataAccessException(Code)
Save or update the given persistent instance, according to its id (matching the configured "unsaved-value"?). Associates the instance with the current Hibernate Session.
Parameters:
  entityName - the name of the persistent entity
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:   org.hibernate.Session.saveOrUpdate(StringObject)



saveOrUpdateAll
void saveOrUpdateAll(Collection entities) throws DataAccessException(Code)
Save or update all given persistent instances, according to its id (matching the configured "unsaved-value"?). Associates the instances with the current Hibernate Session.
Parameters:
  entities - the persistent instances to save or update(to be associated with the Hibernate Session)
throws:
  DataAccessException - in case of Hibernate errors



update
void update(Object entity) throws DataAccessException(Code)
Update the given persistent instance, associating it with the current Hibernate org.hibernate.Session .
Parameters:
  entity - the persistent instance to update
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.update(Object)



update
void update(Object entity, LockMode lockMode) throws DataAccessException(Code)
Update the given persistent instance, associating it with the current Hibernate org.hibernate.Session .

Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.
Parameters:
  entity - the persistent instance to update
Parameters:
  lockMode - the lock mode to obtain
throws:
  org.springframework.orm.ObjectOptimisticLockingFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.update(Object)




update
void update(String entityName, Object entity) throws DataAccessException(Code)
Update the given persistent instance, associating it with the current Hibernate org.hibernate.Session .
Parameters:
  entityName - the name of the persistent entity
Parameters:
  entity - the persistent instance to update
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.update(StringObject)



update
void update(String entityName, Object entity, LockMode lockMode) throws DataAccessException(Code)
Update the given persistent instance, associating it with the current Hibernate org.hibernate.Session .

Obtains the specified lock mode if the instance exists, implicitly checking whether the corresponding database entry still exists.
Parameters:
  entityName - the name of the persistent entity
Parameters:
  entity - the persistent instance to update
Parameters:
  lockMode - the lock mode to obtain
throws:
  org.springframework.orm.ObjectOptimisticLockingFailureException - if not found
throws:
  org.springframework.dao.DataAccessException - in case of Hibernate errors
See Also:   org.hibernate.Session.update(StringObject)




www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.