org.omnifaces.filter

Class FacesExceptionFilter

java.lang.Object

org.omnifaces.filter.HttpFilter

org.omnifaces.filter.FacesExceptionFilter

All Implemented Interfaces:

Filter

public class FacesExceptionFilter
extends HttpFilter

The FacesExceptionFilter will solve 2 problems with exceptions thrown in JSF methods.

1. Mojarra's FacesFileNotFoundException needs to be interpreted as 404.
2. Root cause needs to be unwrapped from FacesException and ELException to utilize standard Servlet API error page handling.

Installation

To get it to run, map this filter on the <servlet-name> of the FacesServlet in the same web.xml.

 <filter>
     <filter-name>facesExceptionFilter</filter-name>
     <filter-class>org.omnifaces.filter.FacesExceptionFilter</filter-class>
 </filter>
 <filter-mapping>
     <filter-name>facesExceptionFilter</filter-name>
     <servlet-name>facesServlet</servlet-name>
 </filter-mapping>
 

Author:

Bauke Scholtz

Constructor Summary

Constructors

Constructor and Description
FacesExceptionFilter()

Method Summary

Modifier and Type	Method and Description
void	doFilter(HttpServletRequest request, HttpServletResponse response, HttpSession session, FilterChain chain) Filter the HTTP request.

Methods inherited from class org.omnifaces.filter.HttpFilter

destroy, doFilter, getFilterConfig, getInitParameter, getServletContext, init, init

Methods inherited from class java.lang.Object

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

Constructor Detail

FacesExceptionFilter

public FacesExceptionFilter()

Method Detail

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)