com.helger.web.servlets.scope

Class AbstractScopeAwareFilter

java.lang.Object

com.helger.servlet.filter.AbstractServletFilter

com.helger.servlet.filter.AbstractHttpServletFilter

com.helger.web.servlets.scope.AbstractScopeAwareFilter

All Implemented Interfaces:

javax.servlet.Filter

public abstract class AbstractScopeAwareFilter
extends com.helger.servlet.filter.AbstractHttpServletFilter

Abstract HTTP servlet filter implementation using the correct scope handling. The scope initialization happens before the main action is executed, and the scope destruction happens after all the whole filter chain finished! If more than one scope aware filter are present in the filter chain, only the filter invoked first creates the request scope. Succeeding scope aware filters wont create a request scope.

Author:

Philip Helger

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractScopeAwareFilter()

Method Summary

Modifier and Type	Method and Description
void	doHttpFilter(javax.servlet.http.HttpServletRequest aHttpRequest, javax.servlet.http.HttpServletResponse aHttpResponse, javax.servlet.FilterChain aChain)
protected abstract com.helger.commons.state.EContinue	doHttpFilter(javax.servlet.http.HttpServletRequest aHttpRequest, javax.servlet.http.HttpServletResponse aHttpResponse, IRequestWebScope aRequestScope) Implement this main filtering method in subclasses.

Methods inherited from class com.helger.servlet.filter.AbstractHttpServletFilter

doFilter

Methods inherited from class com.helger.servlet.filter.AbstractServletFilter

destroy, getFilterConfig, init, init, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractScopeAwareFilter

protected AbstractScopeAwareFilter()

Method Detail

doHttpFilter

@Nonnull
protected abstract com.helger.commons.state.EContinue doHttpFilter(@Nonnull
                                                                             javax.servlet.http.HttpServletRequest aHttpRequest,
                                                                             @Nonnull
                                                                             javax.servlet.http.HttpServletResponse aHttpResponse,
                                                                             @Nonnull
                                                                             IRequestWebScope aRequestScope)
                                                                      throws IOException,
                                                                             javax.servlet.ServletException

Implement this main filtering method in subclasses.

Parameters:

aHttpRequest - The HTTP request. Never null.

aHttpResponse - The HTTP response. Never null.

aRequestScope - The request scope to be used.

Returns:

EContinue.CONTINUE to indicate that the next filter is to be called or EContinue.BREAK to indicate that the next filter does not need to be called! Never return null!

Throws:

IOException - In case of an IO error

javax.servlet.ServletException - For non IO errors

doHttpFilter

public final void doHttpFilter(@Nonnull
                               javax.servlet.http.HttpServletRequest aHttpRequest,
                               @Nonnull
                               javax.servlet.http.HttpServletResponse aHttpResponse,
                               @Nonnull
                               javax.servlet.FilterChain aChain)
                        throws IOException,
                               javax.servlet.ServletException

Specified by:

doHttpFilter in class com.helger.servlet.filter.AbstractHttpServletFilter

Throws:

IOException

javax.servlet.ServletException