首页 > 代码库 > Filter及FilterChain的使用具体解释

Filter及FilterChain的使用具体解释

一、Filter的介绍及使用

什么是过滤器?

Servlet类似,过滤器是一些web应用程序组件,能够绑定到一个web应用程序中。可是与其它web应用程序组件不同的是,过滤器是""在容器的处理过程中的。这就意味着它们会在servlet处理器之前訪问一个进入的请求,而且在外发响应信息返回到客户前訪问这些响应信息。这样的訪问使得过滤器能够检查并改动请求和响应的内容。

过滤器适用于那些地方?

l  为一个web应用程序的新功能建立模型(可被加入到web应用程序中或者从web应用程序中删除而不须要重写基层应用程序代码)

l  向过去的代码加入新功能。

过滤器放在容器结构的什么位置?

过滤器放在web资源之前,能够在请求抵达它所应用的web资源(能够是一个Servlet、一个Jsp页面,甚至是一个HTML页面)之前截获进入的请求,而且在它返回到客户之前截获输出请求。Filter:用来拦截请求,处于client与被请求资源之间,目的是重用代码。Filter链,在web.xml中哪个先配置,哪个就先调用。在filter中也能够配置一些初始化參数。

Java中的Filter 并非一个标准的Servlet ,它不能处理用户请求,也不能对client生成响应。 主要用于对HttpServletRequest 进行预处理,也能够对HttpServletResponse 进行后处理,是个典型的处理链。 

Filter 有例如以下几个用处:

l  HttpServletRequest 到达Servlet 之前,拦截客户的HttpServletRequest  

l  依据须要检查HttpServletRequest ,也能够改动HttpServletRequest 头和数据。 

l  HttpServletResponse 到达client之前,拦截HttpServletResponse  

l  依据须要检查HttpServletResponse ,能够改动HttpServletResponse 头和数据。

Filter 有例如以下几个种类:

l  用户授权的Filter: Filter 负责检查用户请求,依据请求过滤用户非法请求。 

l  日志Filter: 具体记录某些特殊的用户请求。 

l  负责解码的Filter: 包含对非标准编码的请求解码。 

l  能改变XML 内容的XSLTFilter 等。 

一个Filter 可负责拦截多个请求或响应:一个请求或响应也可被多个请求拦截。 

创建一个Filter 仅仅需两个步骤: 
(1)
创建Filter 处理类: 

(2)web.xml 文件里配置Filter  
创建Filter 必须实现javax.servlet.Filter 接口,在该接口中定义了三个方法。 
• void init(FilterConfig config):
用于完毕Filter 的初始化。 
• void destroy():
用于Filter 销毁前,完毕某些资源的回收。 
• void doFilter(ServletRequest request, ServletResponse response,FilterChain chain):
实现过滤功能,该方法就是对每一个请求及响应添加的额外处理。 

过滤器Filter也具有生命周期:init()->doFilter()->destroy(),由部署文件里的filter元素驱动。在servlet2.4中,过滤器相同能够用于请求分派器,但须在web.xml中声明,<dispatcher>INCLUDEFORWARDREQUESTERROR</dispatcher>该元素位于filter-mapping中。 

Filter经常使用的场景:

例一、  日志的记录,当有请求到达时,在该过滤器中进行日志的记录。处理完毕后,进入兴许的Filter或者处理。

步骤1:编写Filter

package test.filter;

 

import javax.servlet.Filter;

import javax.servlet.FilterChain;

import javax.servlet.FilterConfig;

import javax.servlet.ServletContext;

import javax.servlet.ServletRequest;

import javax.servlet.ServletResponse;

import javax.servlet.http.HttpServletRequest;

 

public class LogFilter implements Filter { 

    private FilterConfig config; 

    // 实现初始化方法 

    public void init(FilterConfig config) { 

        this.config = config; 

    } 

    // 实现销毁方法 

    public void destroy() { 

        this.config = null; 

    } 

    public void doFilter(ServletRequest request, ServletResponse response, 

            FilterChain chain) { 

        // 获取ServletContext 对象,用于记录日志 

        ServletContext context = this.config.getServletContext(); 

        long before = System.currentTimeMillis(); 

        System.out.println("開始过滤... "); 

        // 将请求转换成HttpServletRequest 请求 

        HttpServletRequest hrequest = (HttpServletRequest) request; 

        // 记录日志 

        context.log("Filter已经截获到用户的请求的地址: " + hrequest.getServletPath()); 

        try { 

            // Filter 仅仅是链式处理,请求依旧转发到目的地址。 

            chain.doFilter(request, response); 

        } catch (Exception e) { 

            e.printStackTrace(); 

        } 

        long after = System.currentTimeMillis(); 

        // 记录日志 

        context.log("过滤结束"); 

        // 再次记录日志 

        context.log(" 请求被定位到" + ((HttpServletRequest) request).getRequestURI() 

                + "所花的时间为: " + (after - before)); 

    } 

} 

在上面的请求Filter中,仅在日志中记录请求的URL,对全部的请求都运行chain.doFilter(requestreponse)方法,当Filter 对请求过滤后,依旧将请求发送到目的地址。

步骤2:在web.xml中配置Filter

<!-- 定义Filter --> 

<filter> 

    <!-- Filter 的名字 --> 

    <filter-name>log</filter-name> 

    <!-- Filter 的实现类 --> 

    <filter-class> test.filter.LogFilter</filter-class> 

</filter> 

<!-- 定义Filter 拦截地址 --> 

<filter-mapping> 

    <!-- Filter 的名字 --> 

    <filter-name>log</filter-name> 

    <!-- Filter 负责拦截的URL --> 

    <url-pattern>/filter/*</url-pattern>

</filter-mapping> 

通过上述步骤的操作,此时就能够通过URI进行訪问。详细訪问后会在log文件里的localhost文件里产生详细的訪问日志。例如以下所看到的:

2010-12-28 21:12:50 org.apache.catalina.core.ApplicationContext log

信息:  请求被定位到/examples/jsp/jsp2/el/basic-arithmetic.jsp所花的时间为: 0

2010-12-28 21:14:55 org.apache.catalina.core.ApplicationContext log

信息: Filter已经截获到用户的请求的地址: /jsp/jsp2/el/basic-comparisons.jsp

2010-12-28 21:14:56 org.apache.catalina.core.ApplicationContext log

信息: 过滤结束

例二、      进行编码的修正,当有新的请求时,须要将用户传送过来的字符进行又一次编码,以使其能够满足server的编码格式。

1、   编写EncodingFilter

package test.filter;

import java.io.IOException;

import javax.servlet.Filter;

import javax.servlet.FilterChain;

import javax.servlet.FilterConfig;

import javax.servlet.ServletContext;

import javax.servlet.ServletException;

import javax.servlet.ServletRequest;

import javax.servlet.ServletResponse;

 

public class EncodingFilter implements Filter {   

    private FilterConfig filterConfig = null;

    private String encoding = null;   

    //实现销毁方法

    public void destroy() {   

         encoding = null;   

     }   

    //进行详细的过滤

    public void doFilter(ServletRequest request, ServletResponse response,   

             FilterChain chain) throws IOException, ServletException {

        // 获取ServletContext 对象,用于记录日志 

         ServletContext context = this.filterConfig.getServletContext(); 

         context.log("開始设置编码格式");

         String encoding = getEncoding();   

         if (encoding == null){   

             encoding = "gb2312";   

         }

         // 在请求里设置上指定的编码

         request.setCharacterEncoding(encoding);

         chain.doFilter(request, response);  

         context.log("成功设置了编码格式");

     }   

    //初始化配置

    public void init(FilterConfig filterConfig) throws ServletException {

        this.filterConfig = filterConfig;

        this.encoding = filterConfig.getInitParameter("encoding");   

     }   

   

    private String getEncoding() {   

        return this.encoding;   

     }   

} 

步骤2:在web.xml中配置Filter

<!-- 定义Filter --> 

<filter> 

    <!-- Filter 的名字 --> 

    <filter-name>encoding</filter-name> 

    <!-- Filter 的实现类 --> 

<filter-class> test.filter.EncodingFilter</filter-class>

<init-param>   

<param-name>encoding</param-name>   

<param-value>gb2312</param-value>   

</init-param>   

</filter> 

<!-- 定义Filter 拦截地址 --> 

<filter-mapping> 

    <!-- Filter 的名字 --> 

    <filter-name> encoding </filter-name> 

    <!-- Filter 负责拦截的URL --> 

    <url-pattern>/encode/*</url-pattern> 

</filter-mapping> 

通过上述步骤的操作,此时就能够通过URI进行訪问。

例三、用户权限的认证,当用户发送请求时,可以对用户的身份信息进行验证,假设可以通过验证则接下来再进行其他操作,否则直接不进入下一步的处理。

1、   编写身份认证SecurityFilter

package test.filter;

import java.io.IOException;

import javax.servlet.Filter;

import javax.servlet.FilterChain;

import javax.servlet.FilterConfig;

import javax.servlet.ServletContext;

import javax.servlet.ServletException;

import javax.servlet.ServletRequest;

import javax.servlet.ServletResponse;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import javax.servlet.http.HttpSession;

 

public class SecurityFilter implements Filter {

    private FilterConfig filterConfig;

    //初始化方法实现

    @Override

    public void init(FilterConfig filterConfig) throws ServletException {

        this.filterConfig = filterConfig;

    }

    //身份认证的过滤

    @Override

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

            throws IOException, ServletException {

        ServletContext context = this.filterConfig.getServletContext();

        HttpServletRequest req = (HttpServletRequest) request;

        HttpServletResponse res = (HttpServletResponse) response;

 

        HttpSession session = req.getSession();

        //登录后才干进入下一步处理,否则直接进入错误提示页面

        if (session.getAttribute("username") != null) {

            context.log("身份认证通过,进入下一步处理 ");

            chain.doFilter(request, response);

        } else {

            context.log("身份认证失败,直接返回");

            res.sendRedirect("../failure.jsp");

        }

    }

    //实现销毁方法

    @Override

    public void destroy() {

        this.filterConfig = null;

    }

}

步骤2:在web.xml中配置Filter

<!-- 定义Filter --> 

<filter> 

    <!-- Filter 的名字 --> 

    <filter-name>security</filter-name> 

    <!-- Filter 的实现类 --> 

<filter-class> test.filter.SecurityFilter</filter-class>

</filter> 

<!-- 定义Filter 拦截地址 --> 

<filter-mapping> 

    <!-- Filter 的名字 --> 

    <filter-name> security </filter-name> 

    <!-- Filter 负责拦截的URL --> 

    <url-pattern>/security/*</url-pattern> 

</filter-mapping>

通过上述步骤的操作,此时就行通过URI进行訪问。此时假设可以取得Session中的username值时,会直接进入下一步处理,否则直接进入错误页面。

二、过滤链FilterChain 

两个过滤器,EncodingFilter负责设置编码,SecurityFilter负责控制权限,server会依照web.xml中过滤器定义的先后循序组装成一条链,然后一次运行当中的doFilter()方法。运行的顺序就例如以下图所看到的,运行第一个过滤器的chain.doFilter()之前的代码,第二个过滤器的chain.doFilter()之前的代码,请求的资源,第二个过滤器的chain.doFilter()之后的代码,第一个过滤器的chain.doFilter()之后的代码,最后返回响应。 

运行的代码顺序是: 

l  运行EncodingFilter.doFilter()chain.doFilter()之前的部分;request.setCharacterEncoding(encoding);

l  运行SecurityFilter.doFilter()chain.doFilter()之前的部分:推断用户是否已登录。

l  假设用户已登录,则訪问请求的资源。

l  假设用户未登录,则页面重定向到:/failure.jsp

l  运行SecurityFilter.doFilter()chain.doFilter()之后的部分:这里没有代码。

l  运行EncodingFilter.doFilter()chain.doFilter()之后的部分:写入已经完毕的日志。

过滤链的优点是,运行过程中不论什么时候都能够打断,仅仅要不运行chain.doFilter()就不会再运行后面的过滤器和请求的内容。而在实际使用时,就要特别注意过滤链的运行顺序问题,像EncodingFilter就一定要放在全部Filter之前,这样才干确保在使用请求中的数据前设置正确的编码。

Filter及FilterChain的使用具体解释