servlet filter

JSP 技术构建在 Servlet 技术之上，所以 Servlet 和 JSP 的技术本质是一样的， JSP 能做到的， Servlet 都能做到，但是它们却各有所长。 Servlet 比较适合作为控制类组件，比如视图控制器等。另外， Servlet 还可以作为过滤器、监听器等。 Servlet 不仅可以动态生成 HTML 内容，还可以动态生成图形。总而言之， Servlet 在项目中作为控制类的组件，并且处理一些后台业务， JSP 则作为显示组件。  

     在本节，我们将介绍 Servlet 常用的使用方法之一：作为过滤器。在 Servlet 作为过滤器使用时，它可以对客户的请求进行过滤处理，当它处理完成后，它会交给下一个过滤器处理，就这样，客户的请求在过滤链里一个个处理，直到请求发送到目标。举个例子，某个网站里有提交 " 修改的注册信息 " 的网页，当用户填写完成修改信息并提交后，服务端在进行真正的处理时需要做两个处理：客户端的会话是否有效；对提交的数据进行统一的编码，比如 GB2312 。这两个处理可以在由两个过滤器组成的过滤链里进行处理。当过滤器处理成功后，把提交的数据发送到最终目标；如果过滤器处理不成功（比如客户端的会话无效），它将把视图派发到指定的错误页面。可以看出，过滤器就像一扇门，客户端要和服务端的某个目标交互，必须通过这扇门。  

     下面我们来看一个具体的例子，这个例子将介绍怎么开发过滤器，并且介绍怎么在 web.xml 文件里配置过滤器。这个例子里有两个 JSP 页面，前一个页面用户输入一些信息然后提交，后一个页面显示用户提交的信息。在提交信息后，要经过两个过滤器的处理，一个检查用户是否登录，一个把用户的提交信息用 GB2312 进行重新编码。  

     开发一个Filter，这个Filter需要实现Filter接口，Filter接口定义了以下的方法： 

destroy() //由Web容器调用，销毁此Filter
init(FilterConfig filterConfig) ///由Web容器调用，初始化此Filter
doFilter(ServletRequest request, ServletResponse response, 
FilterChain chain)//具体过滤处理代码
 


    下面我们来看对提交信息用GB2312进行重新编码的Filter，见示例14-7、示例14-8。
    【程序源代码】 

1 // ==================== Program Discription =====================
2 // 程序名称：示例14-7 : EncodingFilter .java
3 // 程序目的：学习使用编码过滤器
4 // ==============================================================
5 import javax.servlet.FilterChain;
6 import javax.servlet.ServletRequest;
7 import javax.servlet.ServletResponse;
8 import java.io.IOException;
9 import javax.servlet.Filter;
10 import javax.servlet.http.HttpServletRequest;
11 import javax.servlet.http.HttpServletResponse;
12 import javax.servlet.ServletException;
13 import javax.servlet.FilterConfig;
14 
15 public class EncodingFilter implements Filter
16 {
17     
18     private String targetEncoding = "gb2312";
19     protected FilterConfig filterConfig;
20     
 
21     public void init(FilterConfig config) throws ServletException {
22         this.filterConfig = config;
23         this.targetEncoding = config.getInitParameter("encoding");
24     }
25     
26    
27      public  void doFilter(ServletRequest srequest, 
ServletResponse  sresponse,FilterChain chain)
28         throws IOException, ServletException {
29        
30         HttpServletRequest request = (HttpServletRequest)srequest;
31         request.setCharacterEncoding(targetEncoding);//把请求用指定的方式编码
32         // 把处理发送到下一个过滤器
33        chain.doFilter(srequest,sresponse);  

34     }
35     
36     public void destroy()
37  {
38   this.filterConfig=null;
39  }
40 
41  public void setFilterConfig(final FilterConfig filterConfig)
42  {
43   this.filterConfig=filterConfig;
44  }
45 }
 


    【程序源代码】 

1 // ==================== Program Discription =====================
2 // 程序名称：示例14-8 : LoginFilter.java
3 // 程序目的：学习使用登录过滤器
4 // ==============================================================
5 import javax.servlet.FilterChain;
6 import javax.servlet.ServletRequest;
7 import javax.servlet.ServletResponse;
8 import java.io.IOException;
9 import javax.servlet.Filter;
10 import javax.servlet.http.HttpServletRequest;
11 import javax.servlet.http.HttpServletResponse;
12 import javax.servlet.ServletException;
13 import javax.servlet.FilterConfig;
14
15 public class LoginFilter implements Filter
16 {
17  String LOGIN_PAGE="init.jsp";
18  protected FilterConfig filterConfig;
 
19  public void doFilter(final ServletRequest req,final ServletResponse 
res,FilterChain chain)throws IOException,ServletException
20  {
21    HttpServletRequest hreq = (HttpServletRequest)req;
22          HttpServletResponse hres = (HttpServletResponse)res; 
23          String isLog=(String)hreq.getSession().getAttribute("isLog");  
24 if((isLog!=null)&&((isLog.equals("true"))||(isLog=="true")))//检查是否登录
25    {
26     chain.doFilter(req,res);
27     return ;
28    }
29    else
30     hres.sendRedirect(LOGIN_PAGE);//如果没有登录，把视图派发到登录页面
31  }
32  
33  public void destroy()
34  {
35   this.filterConfig=null;
36  }
37  public void init(FilterConfig config)
38  {
39   this.filterConfig=config;
40  }
41  public void setFilterConfig(final FilterConfig filterConfig)
42  {
43   this.filterConfig=filterConfig;
44  } 
45 }
 


    【程序注解】
    正如前面所说，EncodingFilter的目的是把客户端的请求用指定的方式编码，具体的处理在request.setCharacterEncoding(targetEncoding)完成了。LoginFilter判断用户在进入目标之前是否登录，if((isLog!=null)&&((isLog.equals("true"))||(isLog=="true")))将检查用户是否登录，如果已登录，那么把视图让过滤链继续处理，如果没有登录，把视图派发到登录页面，过滤链处理结束。
下面我们来看怎么在web.xml里配置这两个过滤器，代码如下所示：
    【程序源代码】 

<web-app>
  <filter>
     <filter-name>encoding</filter-name> 
           <filter-class>EncodingFilter</filter-class> 
           <init-param>
             <param-name>encoding</param-name>
             <param-value>gb2312</param-value>
 
     </init-param>
    </filter>    
    <filter>
     <filter-name>auth</filter-name>
     <filter-class>LoginFilter</filter-class>
    </filter>
    
    <filter-mapping> 
       <filter-name>encoding</filter-name> 
       <url-pattern>/*</url-pattern>  
     </filter-mapping>  
    <filter-mapping>
      <filter-name>auth</filter-name>
     <url-pattern>/target.jsp</url-pattern>
    </filter-mapping>    
</web-app>
 


    【程序注解】
    可以看出，配置Filter时，首先指定Filter的名字和Filter的实现类，如果有必要，还要配置Filter的初始参数；然后为Filter做映射，这个映射指定了需要过滤的目标（JSP、Servlet）。在上面的例子中，指定了EncodingFilter 为所有的JSP和Servlet做过滤，LoginFilter为target.jsp做过滤。这样，当客户请求target.jsp时，首先要经过EncodingFilter的处理，然后经过LoginFilter的处理，最后才把请求传递给target.jsp。 

    【运行程序】
    把程序部署到Web服务器里（比如Tomcat），然后启动Web服务器，在浏览器里输入以下URL（根据具体请求改变URL）：http://127.0.0.1:8080/ch14/target.jsp 

    那么Filter将会把视图派发到：http://127.0.0.1:8080/ch14/init.jsp 

    在init.jsp里，我们使用： 

<% session.setAttribute("isLog","true");%>
 


    来设置用户已经登录（这里是简化的，在实际项目中，可能要经过验证处理）。在init.jsp里，可以提交一些中文的信息。由于提交的信息被EncodingFilter使用GB2312统一编码了，故在target.jsp里能够正确显示中文。您可以做一个试验，把 

<filter-mapping> 
       <filter-name>encoding</filter-name> 
       <url-pattern>/*</url-pattern>  
</filter-mapping>
 


改为 

<filter-mapping> 
       <filter-name>encoding</filter-name> 
       <url-pattern>/nothing</url-pattern>  
</filter-mapping>

    然后重新启动Web服务器。那么在target.jsp里，中文将不能正确显示