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里，中文将不能正确显示