|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.springframework.orm.hibernate.SessionFactoryUtils
Helper class featuring methods for Hibernate session handling, allowing for reuse of Hibernate Session instances within transactions.
Supports synchronization with both Spring-managed JTA transactions (i.e. JtaTransactionManager) and non-Spring JTA transactions (i.e. plain JTA or EJB CMT). See the getSession version with all parameters for details.
Used internally by HibernateTemplate, HibernateInterceptor, and HibernateTransactionManager. Can also be used directly in application code, e.g. in combination with HibernateInterceptor.
Note: Spring's Hibernate support requires Hibernate 2.1 (as of Spring 1.0).
getSession(SessionFactory, Interceptor, SQLExceptionTranslator, boolean)
,
HibernateTemplate
,
HibernateInterceptor
,
HibernateTransactionManager
,
JtaTransactionManager
Constructor Summary | |
SessionFactoryUtils()
|
Method Summary | |
static void |
applyTransactionTimeout(net.sf.hibernate.Criteria criteria,
net.sf.hibernate.SessionFactory sessionFactory)
Apply the current transaction timeout, if any, to the given Hibernate Criteria object. |
static void |
applyTransactionTimeout(net.sf.hibernate.Query query,
net.sf.hibernate.SessionFactory sessionFactory)
Apply the current transaction timeout, if any, to the given Hibernate Query object. |
static void |
closeSessionIfNecessary(net.sf.hibernate.Session session,
net.sf.hibernate.SessionFactory sessionFactory)
Close the given Session, created via the given factory, if it isn't bound to the thread. |
static DataAccessException |
convertHibernateAccessException(net.sf.hibernate.HibernateException ex)
Convert the given HibernateException to an appropriate exception from the org.springframework.dao hierarchy. |
static javax.sql.DataSource |
getDataSource(net.sf.hibernate.SessionFactory sessionFactory)
Determine the DataSource of the given SessionFactory. |
static javax.transaction.TransactionManager |
getJtaTransactionManager(net.sf.hibernate.SessionFactory sessionFactory,
net.sf.hibernate.Session session)
Try to retrieve the JTA TransactionManager from the given SessionFactory and/or Session. |
static net.sf.hibernate.Session |
getSession(net.sf.hibernate.SessionFactory sessionFactory,
boolean allowCreate)
Get a Hibernate Session for the given SessionFactory. |
static net.sf.hibernate.Session |
getSession(net.sf.hibernate.SessionFactory sessionFactory,
net.sf.hibernate.Interceptor entityInterceptor,
SQLExceptionTranslator jdbcExceptionTranslator)
Get a Hibernate Session for the given SessionFactory. |
static net.sf.hibernate.Session |
getSession(net.sf.hibernate.SessionFactory sessionFactory,
net.sf.hibernate.Interceptor entityInterceptor,
SQLExceptionTranslator jdbcExceptionTranslator,
boolean allowSynchronization)
Get a Hibernate Session for the given SessionFactory. |
static void |
initDeferredClose(net.sf.hibernate.SessionFactory sessionFactory)
Initialize deferred close for the current thread and the given SessionFactory. |
static boolean |
isDeferredCloseActive(net.sf.hibernate.SessionFactory sessionFactory)
Return if deferred close is active for the current thread and the given SessionFactory. |
static SQLExceptionTranslator |
newJdbcExceptionTranslator(net.sf.hibernate.SessionFactory sessionFactory)
Create an appropriate SQLExceptionTranslator for the given SessionFactory. |
static void |
processDeferredClose(net.sf.hibernate.SessionFactory sessionFactory)
Process Sessions that have been registered for deferred close for the given SessionFactory. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public SessionFactoryUtils()
Method Detail |
public static javax.sql.DataSource getDataSource(net.sf.hibernate.SessionFactory sessionFactory)
sessionFactory
- the SessionFactory to check
SessionFactoryImplementor.getConnectionProvider()
,
LocalDataSourceConnectionProvider
public static SQLExceptionTranslator newJdbcExceptionTranslator(net.sf.hibernate.SessionFactory sessionFactory)
sessionFactory
- the SessionFactory to create the translator for
getDataSource(net.sf.hibernate.SessionFactory)
,
SQLErrorCodeSQLExceptionTranslator
,
SQLStateSQLExceptionTranslator
public static javax.transaction.TransactionManager getJtaTransactionManager(net.sf.hibernate.SessionFactory sessionFactory, net.sf.hibernate.Session session)
sessionFactory
- Hibernate SessionFactorysession
- Hibernate Session (can also be null)
TransactionManager
,
SessionFactoryImplementor.getTransactionManager()
,
Session.getSessionFactory()
,
net.sf.hibernate.impl.SessionFactoryImpl
,
net.sf.hibernate.jca.JCASessionFactoryImpl
public static net.sf.hibernate.Session getSession(net.sf.hibernate.SessionFactory sessionFactory, boolean allowCreate) throws DataAccessResourceFailureException, java.lang.IllegalStateException
This is the getSession method used by typical data access code, in combination with closeSessionIfNecessary called when done with the Session. Note that HibernateTemplate allows to write data access code without caring about such resource handling.
Supports synchronization with both Spring-managed JTA transactions (i.e. JtaTransactionManager) and non-Spring JTA transactions (i.e. plain JTA or EJB CMT). See the getSession version with all parameters for details.
sessionFactory
- Hibernate SessionFactory to create the session withallowCreate
- if a new Session should be created if no thread-bound found
DataAccessResourceFailureException
- if the Session couldn't be created
java.lang.IllegalStateException
- if no thread-bound Session found and allowCreate falsegetSession(SessionFactory, Interceptor, SQLExceptionTranslator, boolean)
,
closeSessionIfNecessary(net.sf.hibernate.Session, net.sf.hibernate.SessionFactory)
,
HibernateTemplate
public static net.sf.hibernate.Session getSession(net.sf.hibernate.SessionFactory sessionFactory, net.sf.hibernate.Interceptor entityInterceptor, SQLExceptionTranslator jdbcExceptionTranslator)
Supports synchronization with both Spring-managed JTA transactions
(i.e. JtaTransactionManager) and non-Spring JTA transactions (i.e. plain JTA
or EJB CMT). See the full getSession
version for details.
sessionFactory
- Hibernate SessionFactory to create the session withentityInterceptor
- Hibernate entity interceptor, or null if nonejdbcExceptionTranslator
- SQLExcepionTranslator to use for flushing the
Session on transaction synchronization (can be null; only used when actually
registering a transaction synchronization)
DataAccessResourceFailureException
- if the Session couldn't be createdgetSession(SessionFactory, Interceptor, SQLExceptionTranslator, boolean)
public static net.sf.hibernate.Session getSession(net.sf.hibernate.SessionFactory sessionFactory, net.sf.hibernate.Interceptor entityInterceptor, SQLExceptionTranslator jdbcExceptionTranslator, boolean allowSynchronization) throws DataAccessResourceFailureException
Supports synchronization with Spring-managed JTA transactions (i.e. JtaTransactionManager) via TransactionSynchronizationManager, to allow for transaction-scoped Hibernate Sessions and proper transactional handling of the JVM-level cache. This will only occur if "allowSynchronization" is true.
Supports synchronization with non-Spring JTA transactions (i.e. plain JTA or EJB CMT) via TransactionSynchronizationManager, to allow for transaction-scoped Hibernate Sessions without JtaTransactionManager. This only applies when a JTA TransactionManagerLookup is specified in the Hibernate configuration, and when "allowSynchronization" is true.
Supports setting a Session-level Hibernate entity interceptor that allows to inspect and change property values before writing to and reading from the database. Such an interceptor can also be set at the SessionFactory level (i.e. on LocalSessionFactoryBean), on HibernateTransactionManager, or on HibernateInterceptor/HibernateTemplate.
sessionFactory
- Hibernate SessionFactory to create the session withentityInterceptor
- Hibernate entity interceptor, or null if nonejdbcExceptionTranslator
- SQLExcepionTranslator to use for flushing the
Session on transaction synchronization (can be null; only used when actually
registering a transaction synchronization)allowSynchronization
- if a new Hibernate Session is supposed to be
registered with transaction synchronization (if synchronization is active).
This will always be true for typical data access code.
DataAccessResourceFailureException
- if the Session couldn't be createdLocalSessionFactoryBean.setEntityInterceptor(net.sf.hibernate.Interceptor)
,
HibernateAccessor.setEntityInterceptor(net.sf.hibernate.Interceptor)
,
HibernateAccessor.setEntityInterceptor(net.sf.hibernate.Interceptor)
,
HibernateTransactionManager
,
JtaTransactionManager
,
TransactionSynchronizationManager
public static void applyTransactionTimeout(net.sf.hibernate.Query query, net.sf.hibernate.SessionFactory sessionFactory)
query
- the Hibernate Query objectsessionFactory
- Hibernate SessionFactory that the Query was created forpublic static void applyTransactionTimeout(net.sf.hibernate.Criteria criteria, net.sf.hibernate.SessionFactory sessionFactory)
criteria
- the Hibernate Criteria objectsessionFactory
- Hibernate SessionFactory that the Criteria was created forpublic static DataAccessException convertHibernateAccessException(net.sf.hibernate.HibernateException ex)
ex
- HibernateException that occured
HibernateAccessor.convertHibernateAccessException(net.sf.hibernate.HibernateException)
,
HibernateAccessor.convertJdbcAccessException(java.sql.SQLException)
,
HibernateTransactionManager.convertHibernateAccessException(net.sf.hibernate.HibernateException)
,
HibernateTransactionManager.convertJdbcAccessException(java.sql.SQLException)
,
JDBCException.getSQLException()
,
SQLExceptionTranslator
public static boolean isDeferredCloseActive(net.sf.hibernate.SessionFactory sessionFactory)
sessionFactory
- Hibernate SessionFactorypublic static void initDeferredClose(net.sf.hibernate.SessionFactory sessionFactory)
Used by OpenSessionInViewFilter and OpenSessionInViewInterceptor when not configured for a single session.
sessionFactory
- Hibernate SessionFactoryprocessDeferredClose(net.sf.hibernate.SessionFactory)
,
closeSessionIfNecessary(net.sf.hibernate.Session, net.sf.hibernate.SessionFactory)
,
OpenSessionInViewFilter.setSingleSession(boolean)
,
OpenSessionInViewInterceptor.setSingleSession(boolean)
public static void processDeferredClose(net.sf.hibernate.SessionFactory sessionFactory)
sessionFactory
- Hibernate SessionFactoryinitDeferredClose(net.sf.hibernate.SessionFactory)
,
closeSessionIfNecessary(net.sf.hibernate.Session, net.sf.hibernate.SessionFactory)
public static void closeSessionIfNecessary(net.sf.hibernate.Session session, net.sf.hibernate.SessionFactory sessionFactory)
session
- Session to closesessionFactory
- Hibernate SessionFactory that the Session was created with
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |