|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.web.filter.GenericFilterBean org.springframework.web.filter.OncePerRequestFilter org.springframework.orm.jpa.support.OpenEntityManagerInViewFilter
public class OpenEntityManagerInViewFilter
Servlet 2.3 Filter that binds a JPA EntityManager to the thread for the entire processing of the request. Intended for the "Open EntityManager in View" pattern, i.e. to allow for lazy loading in web views despite the original transactions already being completed.
This filter works similar to the AOP JpaInterceptor: It just makes JPA EntityManagers available via the thread. It is suitable for non-transactional execution but also for business layer transactions via JpaTransactionManager or JtaTransactionManager. In the latter case, EntityManagers pre-bound by this filter will automatically be used for the transactions.
Looks up the EntityManagerFactory in Spring's root web application context.
Supports a "entityManagerFactoryBeanName" filter init-param in web.xml
;
the default bean name is "entityManagerFactory". Looks up the EntityManagerFactory
on each request, to avoid initialization order issues (when using ContextLoaderServlet,
the root application context will get initialized after this filter).
OpenEntityManagerInViewInterceptor
,
JpaInterceptor
,
JpaTransactionManager
,
JpaTemplate.execute(org.springframework.orm.jpa.JpaCallback)
,
SharedEntityManagerCreator
,
TransactionSynchronizationManager
Field Summary | |
---|---|
static String |
DEFAULT_PERSISTENCE_MANAGER_FACTORY_BEAN_NAME
|
Fields inherited from class org.springframework.web.filter.OncePerRequestFilter |
---|
ALREADY_FILTERED_SUFFIX |
Fields inherited from class org.springframework.web.filter.GenericFilterBean |
---|
logger |
Constructor Summary | |
---|---|
OpenEntityManagerInViewFilter()
|
Method Summary | |
---|---|
protected javax.persistence.EntityManager |
createEntityManager(javax.persistence.EntityManagerFactory emf)
Create a JPA EntityManager to be bound to a request. |
protected void |
doFilterInternal(HttpServletRequest request,
HttpServletResponse response,
FilterChain filterChain)
Same contract as for doFilter, but guaranteed to be just invoked once per request. |
protected String |
getEntityManagerFactoryBeanName()
Return the bean name of the EntityManagerFactory to fetch from Spring's root application context. |
protected javax.persistence.EntityManagerFactory |
lookupEntityManagerFactory()
Look up the EntityManagerFactory that this filter should use. |
protected javax.persistence.EntityManagerFactory |
lookupEntityManagerFactory(HttpServletRequest request)
Look up the EntityManagerFactory that this filter should use, taking the current HTTP request as argument. |
void |
setEntityManagerFactoryBeanName(String entityManagerFactoryBeanName)
Set the bean name of the EntityManagerFactory to fetch from Spring's root application context. |
Methods inherited from class org.springframework.web.filter.OncePerRequestFilter |
---|
doFilter, getAlreadyFilteredAttributeName, shouldNotFilter |
Methods inherited from class org.springframework.web.filter.GenericFilterBean |
---|
addRequiredProperty, afterPropertiesSet, destroy, getFilterConfig, getFilterName, getServletContext, init, initBeanWrapper, initFilterBean, setBeanName, setFilterConfig, setServletContext |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String DEFAULT_PERSISTENCE_MANAGER_FACTORY_BEAN_NAME
Constructor Detail |
---|
public OpenEntityManagerInViewFilter()
Method Detail |
---|
public void setEntityManagerFactoryBeanName(String entityManagerFactoryBeanName)
DEFAULT_PERSISTENCE_MANAGER_FACTORY_BEAN_NAME
protected String getEntityManagerFactoryBeanName()
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException
OncePerRequestFilter
doFilterInternal
in class OncePerRequestFilter
ServletException
IOException
protected javax.persistence.EntityManagerFactory lookupEntityManagerFactory(HttpServletRequest request)
Default implementation delegates to the lookupEntityManagerFactory
without arguments.
lookupEntityManagerFactory()
protected javax.persistence.EntityManagerFactory lookupEntityManagerFactory()
getEntityManagerFactoryBeanName()
protected javax.persistence.EntityManager createEntityManager(javax.persistence.EntityManagerFactory emf)
Can be overridden in subclasses.
emf
- the EntityManagerFactory to useEntityManagerFactory.createEntityManager()
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |