Spring web request interceptor that binds a Hibernate
Session
to the thread for the entire processing of the request.
This class is a concrete expression of the "Open Session in View" pattern, which is a pattern that allows for the lazy loading of associations in web views despite the original transactions already being completed.
This interceptor makes Hibernate Sessions available via the current thread, which will be autodetected by transaction managers. It is suitable for service layer transactions via {@link org.springframework.orm.hibernate4.HibernateTransactionManager}as well as for non-transactional execution (if configured appropriately).
NOTE: This interceptor will by default not flush the Hibernate Session
, with the flush mode being set to FlushMode.NEVER
. It assumes that it will be used in combination with service layer transactions that handle the flushing: the active transaction manager will temporarily change the flush mode to FlushMode.AUTO
during a read-write transaction, with the flush mode reset to FlushMode.NEVER
at the end of each transaction. If you intend to use this interceptor without transactions, consider changing the default flush mode (through the {@link #setFlushMode "flushMode"} property).
In contrast to {@link OpenSessionInViewFilter}, this interceptor is configured in a Spring application context and can thus take advantage of bean wiring..
WARNING: Applying this interceptor to existing logic can cause issues that have not appeared before, through the use of a single Hibernate Session
for the processing of an entire request. In particular, the reassociation of persistent objects with a Hibernate Session
has to occur at the very beginning of request processing, to avoid clashes with already loaded instances of the same objects.
@author Juergen Hoeller
@since 3.1
@see #setSingleSession
@see #setFlushMode
@see OpenSessionInViewFilter
@see org.springframework.orm.hibernate4.HibernateTransactionManager
@see org.springframework.transaction.support.TransactionSynchronizationManager