filter应用案例三：解决全站编码问题

1　说明
　　乱码问题：
　　　　获取请求参数中的乱码问题；
　　　　　　POST请求：request.setCharacterEncoding(“utf-8”)；
　　　　　　GET请求：new String(request.getParameter(“xxx”).getBytes(“iso-8859-1”), “utf-8”)；
　　　　响应的乱码问题：response.setContextType(“text/html;charset=utf-8”)。

　　基本上在每个Servlet中都要处理乱码问题，所以应该把这个工作放到过滤器中来完成。

2　分析
　　其实全站乱码问题的难点就是处理GET请求参数的问题。
　　如果是POST请求，当执行目标Servlet时，Servlet中调用request.getParameter()方法时，就会根据request.setCharacterEncoding()设置的编码来转码！这说明在过滤器中调用request.setCharacterEncoding()方法会影响在目标Servlet中的request.getParameter()方法的行为！
　　但是如果是GET请求，我们又如何能影响request.getParameter()方法的行为呢？这是不好做到的！我们不可能先调用request.getParameter()方法获取参数，然后手动转码后，再施加在到request中！因为request只有getParameter()，而没有setParameter()方法。

　　处理GET请求参数编码问题，需要在Filter中放行时，把request对象给“调包”了，也就是让目标Servlet使用我们“调包”之后的request对象。这说明我们需要保证“调包”之后的request对象中所有方法都要与“调包”之前一样可以使用，并且getParameter()方法还要有能力返回转码之后的参数。

　　这可能让你想起了“继承”，但是这里不能用继承，而是“装饰者模式（Decorator Pattern）”！
　　　　下面是三种对a对象进行增强的手段：
　　　　　　继承：AA类继承a对象的类型：A类，然后重写fun1()方法，其中重写的fun1()方法就是被增强的方法。但是，继承必须要知道a对象的真实类型，然后才能去继承。如果我们不知道a对象的确切类型，而只知道a对象是IA接口的实现类对象，那么就无法使用继承来增强a对象了；
　　　　　　装饰者模式：AA类去实现a对象相同的接口：IA接口，还需要给AA类传递a对象，然后在AA类中所有的方法实现都是通过代理a对象的相同方法完成的，只有fun1()方法在代理a对象相同方法的前后添加了一些内容，这就是对fun1()方法进行了增强；
　　　　　　动态代理：动态代理与装饰者模式比较相似，而且是通过反射来完成的。

　　对request对象进行增强的条件，刚好符合装饰者模式的特点！因为我们不知道request对象的具体类型，但我们知道request是HttpServletRequest接口的实现类。这说明我们写一个类EncodingRequest，去实现HttpServletRequest接口，然后再把原来的request传递给EncodingRequest类！在EncodingRequest中对HttpServletRequest接口中的所有方法的实现都是通过代理原来的request对象来完成的，只有对getParameter()方法添加了增强代码！
　　JavaEE已经给我们提供了一个HttpServletRequestWrapper类，它就是HttpServletRequest的包装类，但它做任何的增强！你可能会说，写一个装饰类，但不做增强，其目的是什么呢？使用这个装饰类的对象，和使用原有的request有什么分别呢？HttpServletRequestWrapper类虽然是HttpServletRequest的装饰类，但它不是用来直接使用的，而是用来让我们去继承的！当我们想写一个装饰类时，还要对所有不需要增强的方法做一次实现是很心烦的事情，但如果你去继承HttpServletRequestWrapper类，那么就只需要重写需要增强的方法即可了。

代码示例：

 import java.io.UnsupportedEncodingException;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletRequestWrapper;

 /**
  * 装饰reqeust
  */
 public class EncodingRequest extends HttpServletRequestWrapper {
     private HttpServletRequest req;
     public EncodingRequest(HttpServletRequest request) {
         super(request);
         this.req = request;
     }

     public String getParameter(String name) {
         String value = req.getParameter(name);
         // 处理编码问题
         try {
             value = new String(value.getBytes("iso-8859-1"), "utf-8");
         } catch (UnsupportedEncodingException e) {
             throw new RuntimeException(e);
         }
         return value;
     }
 }

EncodingRequest

 import java.io.IOException;

 import javax.servlet.Filter;
 import javax.servlet.FilterChain;
 import javax.servlet.FilterConfig;
 import javax.servlet.ServletException;
 import javax.servlet.ServletRequest;
 import javax.servlet.ServletResponse;
 import javax.servlet.http.HttpServletRequest;

 public class EncodingFilter implements Filter {
     public void destroy() {}

     public void doFilter(ServletRequest request, ServletResponse response,
             FilterChain chain) throws IOException, ServletException {
         // 处理post请求编码问题
         request.setCharacterEncoding("utf-8");
         HttpServletRequest req = (HttpServletRequest) request;
         /*
          * 处理GET请求的编码问题
          * 调包request
          * 1. 写一个request的装饰类
          * 2. 在放行时，使用我们自己的request
          */
         if(req.getMethod().equals("GET")) {
             EncodingRequest er = new EncodingRequest(req);
             chain.doFilter(er, response);
         } else if(req.getMethod().equals("POST")) {
             chain.doFilter(request, response);
         }
     }

     public void init(FilterConfig fConfig) throws ServletException {}
 }

EncodingFilter

 import java.io.IOException;

 import javax.servlet.ServletException;
 import javax.servlet.http.HttpServlet;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;

 public class AServlet extends HttpServlet {
     public void doGet(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
         response.setContentType("text/html;charset=utf-8");
         String username = request.getParameter("username");
         response.getWriter().println(username);
     }

     public void doPost(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
         response.setContentType("text/html;charset=utf-8");
         String username = request.getParameter("username");
         response.getWriter().println(username);
     }
 }

AServlet

 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
 <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
 <%
 String path = request.getContextPath();
 String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
 %>

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <html>
   <head>
     <base href="<%=basePath%>">

     <title>My JSP 'index.jsp' starting page</title>
     <meta http-equiv="pragma" content="no-cache">
     <meta http-equiv="cache-control" content="no-cache">
     <meta http-equiv="expires" content="0">
     <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
     <meta http-equiv="description" content="This is my page">
     <!--
     <link rel="stylesheet" type="text/css" href="styles.css">
     -->
   </head>

   <body>
 <a href="<c:url value='/AServlet?username=张三'/>">点击这里</a><br/>
 <form action="<c:url value='/AServlet'/>" method="post">
 用户名：<input type="text" name="username" value="李四"/>
 <input type="submit" value="提交"/>
 </form>
   </body>
 </html>

index.jsp

 <?xml version="1.0" encoding="UTF-8"?>
 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">
   <display-name></display-name>
 <servlet>
     <servlet-name>AServlet</servlet-name>
     <servlet-class>AServlet</servlet-class>
   </servlet>
   <servlet-mapping>
     <servlet-name>AServlet</servlet-name>
     <url-pattern>/AServlet</url-pattern>
   </servlet-mapping>
   <welcome-file-list>
     <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>
   <filter>
     <display-name>EncodingFilter</display-name>
     <filter-name>EncodingFilter</filter-name>
     <filter-class>EncodingFilter</filter-class>
   </filter>
   <filter-mapping>
     <filter-name>EncodingFilter</filter-name>
     <url-pattern>/*</url-pattern>
   </filter-mapping>
 </web-app>

web.xml