ccc.web.filters
Class ErrorHandlingFilter

java.lang.Object
  ccc.web.filters.ErrorHandlingFilter

All Implemented Interfaces:

javax.servlet.Filter

public class ErrorHandlingFilter
extends java.lang.Object
implements javax.servlet.Filter

A servlet action that catches and handles runtime exceptions.

Author:

Civic Computing Ltd.

Constructor Summary

ErrorHandlingFilter()

Method Summary

void	destroy()
protected void	dispatchError(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, RequestFailedException requestEx) Dispatch to the error handler.
protected void	dispatchNotFound(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Dispatch to the 'not found' URI.
protected void	dispatchRedirect(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String relUri) Send a redirect to the client.
void	doFilter(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, javax.servlet.FilterChain chain)
void	init(javax.servlet.FilterConfig filterConfig)

Methods inherited from class java.lang.Object

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

Constructor Detail

ErrorHandlingFilter

public ErrorHandlingFilter()

Method Detail

doFilter

public void doFilter(javax.servlet.ServletRequest request,
                     javax.servlet.ServletResponse response,
                     javax.servlet.FilterChain chain)
              throws java.io.IOException

Specified by:

doFilter in interface javax.servlet.Filter

Throws:

java.io.IOException

dispatchNotFound

protected void dispatchNotFound(javax.servlet.http.HttpServletRequest request,
                                javax.servlet.http.HttpServletResponse response)
                         throws java.io.IOException

Dispatch to the 'not found' URI.

Parameters:

request - The request.

response - The response.

Throws:

java.io.IOException - From servlet API.

dispatchRedirect

protected void dispatchRedirect(javax.servlet.http.HttpServletRequest request,
                                javax.servlet.http.HttpServletResponse response,
                                java.lang.String relUri)
                         throws java.io.IOException

Send a redirect to the client.

Parameters:

request - The incoming request.

response - The outgoing response.

relUri - The relative URI to redirect to.

Throws:

java.io.IOException - Servlet API can throw an IOException.

dispatchError

protected void dispatchError(javax.servlet.http.HttpServletRequest request,
                             javax.servlet.http.HttpServletResponse response,
                             RequestFailedException requestEx)

Dispatch to the error handler.

If there is no handling strategy the exception will be re-thrown.

Parameters:

request - The request.

response - The response.

requestEx - The exception we encountered.

destroy

public void destroy()

Specified by:

destroy in interface javax.servlet.Filter

init

public void init(javax.servlet.FilterConfig filterConfig)

Specified by:

init in interface javax.servlet.Filter