实例:用Servlet开发和配置过滤器

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