java中文亂碼解決之道（八）—–解決URL中文亂碼問題

原文地址：http://cmsblogs.com/?p=1526

我們主要通過兩種形式提交向服務器發送請求：URL、表單。而表單形式一般都不會出現亂碼問題，亂碼問題主要是在URL上面。通過前面幾篇博客的介紹我們知道URL向服務器發送請求編碼過程實在是實在太混亂了。不同的操作系統、不同的瀏覽器、不同的網頁字符集，將導致完全不同的編碼結果。如果程序員要把每一種結果都考慮進去，是不是太恐怖了？有沒有辦法，能夠保證客戶端只用一種編碼方法向服務器發出請求？

有！這裏我主要提供以下幾種方法

一、javascript

使用javascript編碼不給瀏覽器插手的機會，編碼之後再向服務器發送請求，然後在服務器中解碼。在掌握該方法的時候，我們需要料及javascript編碼的三個方法：escape()、encodeURI()、encodeURIComponent()。

escape

採用SIO Latin字符集對指定的字符串進行編碼。所有非ASCII字符都會被編碼爲%xx格式的字符串，其中xx表示該字符在字符集中所對應的16進制數字。例如，格式對應的編碼爲%20。它對應的解碼方法爲unescape()。

事實上escape()不能直接用於URL編碼，它的真正作用是返回一個字符的Unicode編碼值。比如上面“我是cm”的結果爲%u6211%u662Fcm，其中“我”對應的編碼爲6211，“是”的編碼爲662F，“cm”編碼爲cm。

注意，escape()不對”+”編碼。但是我們知道，網頁在提交表單的時候，如果有空格，則會被轉化爲+字符。服務器處理數據的時候，會把+號處理成空格。所以，使用的時候要小心。

encodeURI

對整個URL進行編碼，它採用的是UTF-8格式輸出編碼後的字符串。不過encodeURI除了ASCII編碼外對於一些特殊的字符也不會進行編碼如：! @ # $& * ( ) = : / ; ? + ‘。

encodeURIComponent()

把URI字符串採用UTF-8編碼格式轉化成escape格式的字符串。相對於encodeURI，encodeURIComponent會更加強大，它會對那些在encodeURI()中不被編碼的符號（; / ? : @ & = + $ , #）統統會被編碼。但是encodeURIComponent只會對URL的組成部分進行個別編碼，而不用於對整個URL進行編碼。對應解碼函數方法decodeURIComponent。

當然我們一般都是使用encodeURI方來進行編碼操作。所謂的javascript兩次編碼後臺兩次解碼就是使用該方法。javascript解決該問題有一次轉碼、兩次轉碼兩種解決方法。

一次轉碼

javascript轉碼：

var url = '<s:property value="webPath" />/ShowMoblieQRCode.servlet?name=我是cm';
window.location.href = encodeURI(url);

轉碼後的URL：http://127.0.0.1:8080/perbank/ShowMoblieQRCode.servlet?name=%E6%88%91%E6%98%AFcm

後臺處理:

String name = request.getParameter("name");
        System.out.println("前臺傳入參數：" + name);
        name  = new String(name.getBytes("ISO-8859-1"),"UTF-8");
        System.out.println("經過解碼後參數：" + name);

輸出結果：

前臺傳入參數：??????cm 
經過解碼後參數：我是cm

二次轉碼

javascript

var url = '<s:property value="webPath" />/ShowMoblieQRCode.servlet?name=我是cm';
window.location.href = encodeURI(encodeURI(url));

轉碼後的url:http://127.0.0.1:8080/perbank/ShowMoblieQRCode.servlet?name=%25E6%2588%2591%25E6%2598%25AFcm

後臺處理：

        String name = request.getParameter("name");
        System.out.println("前臺傳入參數：" + name);
        name  = URLDecoder.decode(name,"UTF-8");
        System.out.println("經過解碼後參數：" + name);

輸出結果：

前臺傳入參數：E68891E698AFcm 
經過解碼後參數：我是cm

filter

使用過濾器，過濾器LZ提供兩種，第一種設置編碼，第二種直接在過濾器中進行解碼操作。

過濾器1

該過濾器是直接設置request的編碼格式的。

public class CharacterEncoding implements Filter {

    private FilterConfig config ;
    String encoding = null;
    
    public void destroy() {
        config = null;
    }

    public void doFilter(ServletRequest request, ServletResponse response,
            FilterChain chain) throws IOException, ServletException {
        request.setCharacterEncoding(encoding);
        chain.doFilter(request, response);
    }

    public void init(FilterConfig config) throws ServletException {
        this.config = config;
        //獲取配置參數
        String str = config.getInitParameter("encoding");
        if(str!=null){
            encoding = str;
        }
    }

}

配置：

<!-- 中文過濾器的配置 -->
    <filter>
        <filter-name>chineseEncoding</filter-name>
        <filter-class>com.test.filter.CharacterEncoding</filter-class>
        
        <init-param>
            <param-name>encoding</param-name>
            <param-value>utf-8</param-value>
        </init-param>
    </filter>
    
    <filter-mapping>
        <filter-name>chineseEncoding</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

過濾器2

該過濾器在處理方法中將參數直接進行解碼操作，然後將解碼後的參數重新設置到request的attribute中。

 

public class CharacterEncoding implements Filter {
    protected FilterConfig filterConfig ;
    String encoding = null;
    
    public void destroy() {
        this.filterConfig = null;
    }

    /**
     * 初始化
     */
    public void init(FilterConfig filterConfig) {
        this.filterConfig = filterConfig;
    }

    /**
     * 將 inStr 轉爲 UTF-8 的編碼形式
     * 
     * @param inStr 輸入字符串
     * @return UTF - 8 的編碼形式的字符串
     * @throws UnsupportedEncodingException
     */
    private String toUTF(String inStr) throws UnsupportedEncodingException {
        String outStr = "";
        if (inStr != null) {
            outStr = new String(inStr.getBytes("iso-8859-1"), "UTF-8");
        }
        return outStr;
    }

    /**
     * 中文亂碼過濾處理
     */
    public void doFilter(ServletRequest servletRequest,
            ServletResponse servletResponse, FilterChain chain) throws IOException,
            ServletException {
        HttpServletRequest request = (HttpServletRequest) servletRequest;
        HttpServletResponse response = (HttpServletResponse) servletResponse;

        // 獲得請求的方式 (1.post or 2.get), 根據不同請求方式進行不同處理
        String method = request.getMethod();
        // 1. 以 post 方式提交的請求 , 直接設置編碼爲 UTF-8
        if (method.equalsIgnoreCase("post")) {
            try {
                request.setCharacterEncoding("UTF-8");
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }
        }
        // 2. 以 get 方式提交的請求
        else {
            // 取出客戶提交的參數集
            Enumeration<String> paramNames = request.getParameterNames();
            // 遍歷參數集取出每個參數的名稱及值
            while (paramNames.hasMoreElements()) {
                String name = paramNames.nextElement(); // 取出參數名稱
                String values[] = request.getParameterValues(name); // 根據參數名稱取出其值
                // 如果參數值集不爲空
                if (values != null) {
                    // 遍歷參數值集
                    for (int i = 0; i < values.length; i++) {
                        try {
                            // 迴圈依次將每個值調用 toUTF(values[i]) 方法轉換參數值的字元編碼
                            String vlustr = toUTF(values[i]);
                            values[i] = vlustr;
                        } catch (UnsupportedEncodingException e) {
                            e.printStackTrace();
                        }
                    }
                    // 將該值以屬性的形式藏在 request
                    request.setAttribute(name, values);
                }
            }

        }
        // 設置響應方式和支持中文的字元集
        response.setContentType("text/html;charset=UTF-8");

        // 繼續執行下一個 filter, 無一下個 filter 則執行請求
        chain.doFilter(request, response);
    }
}

配置：

<!-- 中文過濾器的配置 -->
    <filter>
        <filter-name>chineseEncoding</filter-name>
        <filter-class>com.test.filter.CharacterEncoding</filter-class>
    </filter>
    
    <filter-mapping>
        <filter-name>chineseEncoding</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

其他

1、設置pageEncoding、contentType

<%@ page language="java" contentType="text/html;charset=UTF-8" pageEncoding="UTF-8"%>

2、設置tomcat的URIEncoding

在默認情況下，tomcat服務器使用的是ISO-8859-1編碼格式來編碼的，URIEncoding參數對get請求的URL進行編碼，所以我們只需要在tomcat的server.xml文件的<Connector>標籤中加上URIEncoding=”utf-8″即可。