org.omnifaces.filter

Class HttpFilter

java.lang.Object

org.omnifaces.filter.HttpFilter

All Implemented Interfaces:

Filter

Direct Known Subclasses:

CharacterEncodingFilter, FacesExceptionFilter, FacesViewsForwardingFilter, GzipResponseFilter, OnDemandResponseBufferFilter

public abstract class HttpFilter
extends Object
implements Filter

An abstract filter for HTTP requests. It provides a convenient abstract doFilter() method providing the HTTP servlet request, response and session so that there's no need to cast them everytime. Also, default implementations of init(FilterConfig) and destroy() are provided, so that there's no need to implement them everytime even when not really needed.

Author:

Arjan Tijms, Bauke Scholtz

Constructor Summary

Constructors

Constructor and Description
HttpFilter()

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy()
abstract void	doFilter(HttpServletRequest request, HttpServletResponse response, HttpSession session, FilterChain chain) Filter the HTTP request.
void	doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
protected FilterConfig	getFilterConfig() Returns the filter config.
protected String	getInitParameter(String name) Returns the value of the filter init parameter associated with the given name.
protected ServletContext	getServletContext() Returns the servlet context.
void	init() Convenience init() method without FilterConfig parameter which will be called by init(FilterConfig).
void	init(FilterConfig filterConfig) Called by the servlet container when the filter is about to be placed into service.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpFilter

public HttpFilter()

Method Detail

init

public void init(FilterConfig filterConfig)
          throws ServletException

Called by the servlet container when the filter is about to be placed into service. This implementation stores the FilterConfig object for later use by the getter methods. When overriding this method, call super.init(config), otherwise the getter methods will throw an illegal state exception.

Specified by:

init in interface Filter

Throws:

ServletException

init

public void init()
          throws ServletException

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

Throws:

ServletException - When filter's initialization failed.

doFilter

public void doFilter(ServletRequest request,
            ServletResponse response,
            FilterChain chain)
              throws ServletException,
                     IOException

Specified by:

doFilter in interface Filter

Throws:

ServletException

IOException

doFilter

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

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

Throws:

ServletException

IOException

See Also:

Filter.doFilter(ServletRequest, ServletResponse, FilterChain)

destroy

public void destroy()

Specified by:

destroy in interface Filter

getFilterConfig

protected FilterConfig getFilterConfig()

Returns the filter config.

Returns:

The filter config.

getInitParameter

protected String getInitParameter(String name)

Returns the value of the filter init parameter associated with the given name.

Parameters:

name - The filter init parameter name to return the associated value for.

Returns:

The value of the filter init parameter associated with the given name.

getServletContext

protected ServletContext getServletContext()

Returns the servlet context.

Returns:

The servlet context.