org.omnifaces.cdi.eager

Class EagerBeansFilter

java.lang.Object

org.omnifaces.filter.HttpFilter

org.omnifaces.cdi.eager.EagerBeansFilter

All Implemented Interfaces:

Filter

public class EagerBeansFilter
extends HttpFilter

A servlet Filter that can be used as alternative for EagerBeansWebListener.

This instantiates eager request scoped beans during request processing at the point where this filter is inserted in the chain.

This is needed for those situations where the CDI request scope is NOT available in a ServletRequestListener, such as is the case for GlassFish 3 (note that this is not spec compliant, CDI request scope should be available) and where session scoped beans cannot be instantiated from an HttpSessionListener such as is the case for GlassFish 3 again.

If this Filter is installed EagerBeansWebListener main function (instantiating request and session scoped beans) will be automatically disabled.

Naturally this filter should not be enabled for environments where CDI is not available at all.

Since:

1.8

Author:

Arjan Tijms

Constructor Summary

Constructors

Constructor and Description
EagerBeansFilter()

Method Summary

Modifier and Type	Method and Description
void	doFilter(HttpServletRequest request, HttpServletResponse response, HttpSession session, FilterChain chain) Filter the HTTP request.
void	init() Convenience init() method without FilterConfig parameter which will be called by init(FilterConfig).

Methods inherited from class org.omnifaces.filter.HttpFilter

destroy, doFilter, getFilterConfig, getInitParameter, getServletContext, init

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EagerBeansFilter

public EagerBeansFilter()

Method Detail

init

public void init()
          throws ServletException

Description copied from class: HttpFilter

Convenience init() method without FilterConfig parameter which will be called by init(FilterConfig).

Overrides:

init in class HttpFilter

Throws:

ServletException - When filter's initialization failed.

doFilter

public void doFilter(HttpServletRequest request,
                     HttpServletResponse response,
                     HttpSession session,
                     FilterChain chain)
              throws ServletException,
                     IOException

Description copied from class: HttpFilter

Filter the HTTP request. The session argument is null if there is no session.

Specified by:

doFilter in class HttpFilter

Parameters:

request - The HTTP request.

response - The HTTP response.

session - The HTTP session, if any, else null.

chain - The filter chain to continue.

Throws:

ServletException - As wrapper exception when something fails in the request processing.

IOException - Whenever something fails at I/O level.

See Also:

Filter.doFilter(ServletRequest, ServletResponse, FilterChain)