Servlet中的Filter技术

 Filter 技术是servlet 2.3 新增加的功能.servlet2.3是sun公司与2000年10月发布的,它的开发者包括许多个人和公司团体,充分体现了sun公司所倡导的代码开放性原则.由于众多的参与者的共同努力,servlet2.3比以往功能都强大了许多,而且性能也有了大幅提高.
它新增加的功能包括:
1. 应用程序生命周期事件控制;
2. 新的国际化;
3. 澄清了类的装载规则;
4. 新的错误及安全属性;
5. 不赞成使用HttpUtils 类;
6. 各种有用的方法;
7. 阐明并扩展了几个servlet DTD;
8. filter功能.
其中最重要的就是filter功能.它使用户可以改变一个request和修改一个response. Filter 不是一个servlet,它不能产生一个response,它能够在一个request到达servlet之前预处理request,也可以在离开 servlet时处理response.换种说法,filter其实是一个”servlet chaining”(servlet 链).一个filter 包括:
1. 在servlet被调用之前截获;
2. 在servlet被调用之前检查servlet request;
3. 根据需要修改request头和request数据;
4. 根据需要修改response头和response数据;
5. 在servlet被调用之后截获.
你能够配置一个filter 到一个或多个servlet;单个servlet或servlet组能够被多个filter 使用.几个实用的filter 包括:用户辨认filter,日志filter,审核filter,加密filter,符号filter,能改变xml内容的XSLT filter等.
一个filter必须实现javax.servlet.Filter接口并定义三个方法:
1.void setFilterConfig(FilterConfig config) //设置filter 的配置对象;
2. FilterConfig getFilterConfig() //返回filter的配置对象;
3. void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) //执行filter 的工作.
服务器每次只调用setFilterConfig方法一次准备filter 的处理;调用doFilter方法多次以处理不同的请求.FilterConfig接口有方法可以找到filter名字及初始化参数信息.服务器可以设置 FilterConfig为空来指明filter已经终结.
每一个filter从doFilter()方法中得到当前的request及response.在这个方法里,可以进行任何的针对request及 response的操作.(包括收集数据,包装数据等).filter调用chain.doFilter()方法把控制权交给下一个filter.一个 filter在doFilter()方法中结束.如果一个filter想停止request处理而获得对response的完全的控制,那它可以不调用下一个filter.
一个filter可以包装request 或response以改变几个方法和提供用户定制的属性.Api2.3提供了HttpServletRequestWrapper 和HttpServletResponseWrapper来实现.它们能分派最初的request和response.如果要改变一个方法的特性,必须继承wapper和重写方法.下面是一段简单的日志filter用来记录所有request的持续时间.

 

 

servlet的filter接口的实现类

public class LogFilter implements Filter {
          FilterConfig config;

          public void setFilterConfig(FilterConfig config) {
                    this.config = config;
          }   

           public FilterConfig getFilterConfig() {
                     return config;
           }

            public void doFilter(ServletRequest req,
                      ServletResponse res, FilterChain chain) {
                      ServletContext context = getFilterConfig().getServletContext();
                      long bef = System.currentTimeMillis();

 

                      // no chain parameter needed here 。把控制权交给下一个filter，否则请求不会响应。

                      chain.doFilter(req, res);

 

                      long aft = System.currentTimeMillis();
                      context.log("Request to " + req.getRequestURI()
                      + ": " + (aft-bef));
           }
}

 

web.xml中的配置

<!-- 采用过滤器对已经迁出的纳税户进行过滤 -->
<filter>
      <filter-name>LogFilter</filter-name> <!-- 过滤器名字，随自己定义 -->
      <filter-class>com.common.filter.LogFilter</filter-class> <!--  实现了过滤器接口的类  -->
 </filter>
 <filter-mapping>
      <filter-name>LogFilter</filter-name> <!-- 过滤器名字，与上面定义的保持一致 -->
      <url-pattern>/*</url-pattern> <!-- 过滤的url -->
 </filter-mapping>