Servlet字符编码过滤器

在Java Web程序开发中，由于Web容器内部使用编码格式并不支持中文字符集，所以，处理浏览器请求中的中文数据就会出现乱码的现象。由于Web容器使用了ISO-8859-1的编码格式，所以在Web应用的业务处理中也会使用ISO-8859-1编码格式。虽然浏览器提交的请求使用的是中文编码格式UTF-8，但经过业务处理中的ISO-8859-1编码，仍然会出现中文乱码现象。解决此问题的方法非常简单，在业务处理中重新指定中文字符集进行编码即可解决。在实际的开发过程中，如果通过每一个业务处理指定中文字符集编码，则操作过于繁琐，而且容易遗漏某一个业务中的字符编码设置；如果通过过滤器来处理字符编码，就可以做到简单又万无一失。

例1. 实现图书信息的添加功能，并创建字符编码过滤器，避免中文乱码现象的产生。

（1）创建字符编码过滤器对象，其名称为CharactorFilter类。该类实现了javax.servlet.Filter接口，并在doFilter()方法中对请求中的字符编码格式进行设置，关键代码如下：

package com.cn.gao;

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;

public class CharactorFilter implements Filter {
    String encoding = null;  //字符编码
    
    public void destroy() {
        encoding = null;

    }

    public void doFilter(ServletRequest request, ServletResponse response,
            FilterChain chain) throws IOException, ServletException {
        if(encoding != null){
            request.setCharacterEncoding(encoding);  //设置request的编码格式
            response.setContentType("text/html;charset="+encoding); //设置response字符编码
        }
        chain.doFilter(request, response);  //传递给下一个过滤器
    }

    public void init(FilterConfig filterConfig) throws ServletException {
        encoding = filterConfig.getInitParameter("encoding"); //获取初始化参数

    }

}

上面代码中的encoding是CharactorFilter类定义的字符编码格式成员变量，该变量在过滤器的初始化方法init()中被赋值，它的值是通过FilterConfig对象读取配置文件中的初始化参数获取的。

在创建了过滤器对象之后，还需要对过滤器进行一定的配置才可以正常使用。过滤器CharactorFilter的配置代码如下：

<?xml version="1.0" encoding="gbk"?>
<web-app version="2.5" 
    xmlns="http://java.sun.com/xml/ns/javaee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  <!-- 过滤器声明 -->
  <filter>
      <filter-name>CharactorFilter</filter-name>
      <filter-class>com.cn.gao.CharactorFilter</filter-class>
      <init-param>
          <param-name>encoding</param-name>
          <param-value>gbk</param-value>
      </init-param>
  </filter>
      <filter-mapping>
          <filter-name>CharactorFilter</filter-name>  
          <url-pattern>/*</url-pattern>    
      </filter-mapping>
</web-app>

在过滤器CharactorFilter的配置声明中，实例将它的初始化参数encoding的值设置为GB18030,它与JSP页面的编码格式相同，支持中文。

技巧：在web.xml文件中配置过滤器，其过滤器的URL映射可以使用正则表达式进行配置，如实例中使用“/*”来匹配所有请求。

（2）创建名称为AddServlet的类，该类继承HttpServlet，是处理添加图书信息请求的Servlet对象。关键代码如下：

package com.cn.gao;

import java.io.IOException;
import java.io.PrintWriter;

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

public class AddServlet extends HttpServlet {

    private static final long serialVersionUID = 1L;
    
    //处理GET请求
    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        doPost(request, response);
    }

    //处理POST请求
    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        PrintWriter out = response.getWriter();
        String id = request.getParameter("id"); //获取图书编号
        String name = request.getParameter("name"); //获取图书名称
        String author = request.getParameter("author"); //获取作者
        String price = request.getParameter("price"); //获取价格
        out.print("<h2>图书信息添加成功</h2><hr>"); //输出图书信息
        out.print("图书编号："+id+"<br>");
        out.print("图书名称："+name+"<br>");
        out.print("作       者："+author+"<br>");
        out.print("价       格："+price+"<br>");
        out.flush();  //刷新流
        out.close();  //关闭流
    }

}

技巧：在Java Web程序开发中，通常情况下，Servlet所处理的请求类型都是GET或POST，所以可以在doGet()方法中调用doPost()方法，把业务处理代码写到doPost()方法中，或在doPost()方法中调用doGet()方法，把业务处理代码写到doGet()方法中，无论Servlet接收的请求类型是GET还是POST，Servlet都对其进行处理。

在编写了Servlet类之后，还需要在web.xml文件中对Servlet进行配置，其配置代码如下：

<servlet>
    <description>This is the description of my J2EE component</description>
    <display-name>This is the display name of my J2EE component</display-name>
    <servlet-name>AddServlet</servlet-name>
    <servlet-class>com.cn.gao.AddServlet</servlet-class>
  </servlet>

  <servlet-mapping>
    <servlet-name>AddServlet</servlet-name>
    <url-pattern>/AddServlet</url-pattern>
  </servlet-mapping>

（3）创建名称为index1.jsp的页面，它是程序中的主页。该页面主要用来放置添加图书信息的表单，其关键代码如下：

<%@ page language="java" import="java.util.*" pageEncoding="GB18030"%>
<%
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 'index1.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>
    <form action="AddServlet" method="post">
        <table align="center" border="1" width="350">
            <tr>
                <td class="2" align="center" colspan="2">
                    <h2>添加图书信息</h2>
                </td>
            </tr>
            <tr>
                <td align="right">图书编号：</td>
                <td>
                    <input type="text" name="id"/>
                </td>
            </tr>
            <tr>
                <td align="right">图书名称：</td>
                <td>
                    <input type="text" name="name"/>
                </td>
            </tr>
            <tr>
                <td align="right">作        者：</td>
                <td>
                    <input type="text" name="author"/>
                </td>
            </tr>
            <tr>
                <td align="right">价        格：</td>
                <td>
                    <input type="text" name="price"/>
                </td>
            </tr>
            <tr>
                <td class="2" align="center" colspan="2">
                    <input type="submit" name="Submit" value="添  加"/>
                </td>
            </tr>
        </table>
    </form>
  </body>
</html>

编写完成index1.jsp页面后，即可部署发布程序，运行后界面如下：

单击添加按钮，效果如下：