JSP中文乱码问题终极解决方案(下)

摘要:

  本文首先从四个方面给出了在使用JSP过程中可能出现中文乱码的情形,具体包括JSP页面中文乱码、JSP源文件中文乱码、GET 请求的请求参数为中文乱码 和 POST 请求的请求参数为中文乱码四种情形,并针对每种情形给出了相应的终极解决方案。


一. JSP页面与JSP源文件乱码

  在介绍JSP页面与JSP源文件的乱码问题前,首先我们必须对JSP页面中文乱码问题与JSP源文件中文乱码问题有一个清晰的概念,即:

  • JSP页面中文乱码问题是指用户在浏览器看到的服务器所返回的jsp页面中,中文字符不能正常显示;
  • JSP源文件中文乱码问题是指在编辑器保存JSP源文件后,中文字符不能正常显示。

    因此,这是两个不同层面的问题。接下来,我们分别解决这两个问题。


1、JSP页面乱码

  我们先在记事本中编写一个JSP程序,如下:

<!-- 示例1 -->
<%@ page language="java" import="java.util.*"%>
<html>
  <head>
    <title>JSP页面中文乱码</title>
  </head>
  <body>
        中国<br>
        <%="中国" %>
  </body>
</html>

  上面这个JSP程序是在页面显示几句中文而且标题也是中文,运行后在浏览器中显示如图所示:

              JSP页面中文乱码.png-15.4kB

  原因在于没有在JSP中指定 页面显示的编码,消除乱码的解决方案就是将上面代码中的page命令修改成如下所示即可:

<!-- 示例2 -->
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<html>
  <head>
    <title>JSP页面中文乱码</title>
  </head>
  <body>
        中国<br>
        <%="中国" %>
  </body>
</html>

  再次运行中文正常显示,原理就是 向页面指定编码为utf-8,那么页面就会按照此编码来显示,于是乱码消失。


2、JSP源文件乱码

1). JSP源文件乱码 与 Eclipse/MyEclipse 对JSP的默认编码设置

  如果我们在Eclipse/MyEclipse中打开上面示例1的jsp源文件,由于Eclipse/MyEclipse中默认的JSP编码格式为ISO-8859-1,所以当打开由其他编辑器编辑的JSP文件时会出现乱码,如图所示:

             

  对于这个问题,我们只需要更改一下 Eclipse/MyEclipse 中对JSP的默认编码并update就可以了,修改的地方(我的MyEclipse版本为 10)如图所示:

            myeclipse对JSP源文件的编码 .png-31.6kB

  修改后,对于在Eclipse/MyEclipse所创建的任何一个JSP源文件,其默认编码方式均为 UTF-8,例如:

            修改后的效果.png-23.8kB


  如果不做上述修改,如果我们在Eclipse/MyEclipse中编辑的JSP中存在中文字符,那么当我们保存该页面时,会弹出以下对话框:

             iso-8859-1.png-11kB

  但是,我们如果我们提前按如上步骤设置后,JSP源文件就能正常保存、编译。


2). Eclipse/MyEclipse 创建 JSP时 pageEncoding 的默认值设置

  我们在编辑的JSP文件时,尤其在包含中文字符时,一定要在page编译指令中恰当地指明 pageEncoding 的值,否则在浏览器访问该JSP页面时,其中的中文就会显示为乱码。因为一旦缺省 pageEncoding 时,其值就会被默认指定为 “iso-8859-1”,该字符集不支持中文。此外,使用 Eclipse/MyEclipse 进行开发的伙伴们都知道,这两个IDE生成的JSP模板的pageEncoding的默认值是“iso-8859-1”。为方便开发,我们可以更改Eclipse/MyEclipse生成JSP模板时pageEncoding的默认值,修改的地方(我的MyEclipse版本为10)如图所示:

            pageEncoding.png-17.2kB

  这样,通过以上两步的设置,当我们在 Eclipse/MyEclipse 中创建一个新的JSP文件时,该源文件在Eclipse/MyEclipse中的默认编码方式为utf-8,因此就不会导致 JSP源文件乱码;并且其 pageEncoding 的值会被自动设为“utf-8”,这就不会导致JSP页面乱码。


二. GET 请求的请求参数为中文情形

1、URL传递参数中文乱码

<!-- 请求URL示例:http://localhost:8080/Demo/request/request2.jsp?name=大将&gender=男 -->

<%@ page contentType="text/html; charset=utf-8" language="java"
    pageEncoding="utf-8" errorPage="" import="java.net.*"%>
<head>
<title>URL传递参数中文乱码</title>
</head>
<body>

    <%! private String rawQueryString = null;  %>

    <%
        // 获取name请求参数的值
        String name = request.getParameter("name");
        // 获取gender请求参数的值
        String gender = request.getParameter("gender");

        out.print("---------------------原生查询字符串-----------------------</br>");
        rawQueryString = request.getQueryString();
        out.print(rawQueryString + "</br>");
    %>

    <%
        out.print("</br>---------------------方式一:直接打印请求参数-----------------------</br>");
        out.print( "名字 : " + name +"</br>");
        out.print( "性别 : " + gender + "</br>");
    %>

    <%
        out.print("</br>---------------------方式二:利用String进行转码-----------------------</br>");
        out.print( "名字 : " + new String(name.getBytes("iso-8859-1"),"utf-8") +"</br>");
        out.print( "性别 : " + new String(gender.getBytes("iso-8859-1"),"utf-8") +"</br>");
    %>

    <%
        out.print("</br>---------------------方式三:利用URLDecoder进行解码-----------------------</br>");
        String queryString = URLDecoder.decode(rawQueryString, "utf-8");
        String[] queryParams = queryString.split("&");

        out.print( "名字 : " + queryParams[0].split("=")[1] + "</br>");
        out.print( "性别 : " + queryParams[1].split("=")[1] +"</br>");
    %>
</body>
</html>

运行结果如下图所示:

              GET URL参数.png-32.9kB


2、表单提交中文乱码

  该示例由 “收集参数的表单页” 和 “表单提交参数显示页”两部分构成。

收集参数的表单页:

<%@ page contentType="text/html; charset=utf-8" language="java"
    pageEncoding="utf-8" errorPage=""%>
<head>
<title>收集参数的表单页</title>
</head>
<body>
    <form id="form" action="request1.jsp" method="get">
        用户名:<br /> <input type="text" name="name"><hr /> 性别:<br /> 男:<input
            type="radio" name="gender" value="男"> 女:<input type="radio"
                name="gender" value="女"><hr /> 喜欢的颜色:<br /> 红:<input
                    type="checkbox" name="color" value="红"> 绿:<input
                        type="checkbox" name="color" value="绿"> 蓝:<input
                            type="checkbox" name="color" value="蓝"><hr /> 来自的国家:<br />
                                <select name="country">
                                    <option value="中国">中国</option>
                                    <option value="美国">美国</option>
                                    <option value="俄罗斯">俄罗斯</option>
                            </select>
                            <hr />
        <input type="submit" value="提交">
        <input type="reset" value="重置">
    </form>
</body>
</html>

表单提交参数显示页:

<%@ page language="java" import="java.util.*,java.net.*"
    contentType="text/html; charset=utf-8" pageEncoding="utf-8"
    errorPage=""%>
<html>
<head>
<title>表单提交中文乱码</title>
</head>
<body>

    <%! private String rawQueryString = null;  %>

    <%
        /* 对于get请求,该语句对避免中文参数乱码不起任何作用 */
        request.setCharacterEncoding("utf-8");

        String name = request.getParameter("name");
        String gender = request.getParameter("gender");
        String[] color = request.getParameterValues("color");
        String country = request.getParameter("country");

        out.print("---------------------原生查询字符串-----------------------</br>");
        rawQueryString = request.getQueryString();
        if (rawQueryString != null)
            out.print(rawQueryString + "</br>");
    %>

    <%
        out.print("</br>---------------------方式一:直接打印请求参数-----------------------</br>");
        out.print("name: " + name + "</br>");
        out.print("gender: " + gender + "</br>");
        out.print("color: ");
        for (String s : color) {
            out.println(s);
        }
        out.print("</br>");
        out.print("country: " + country + "</br>");
    %>

    <%
        out.print("</br>---------------------方式二:利用String进行转码-----------------------</br>");

        out.print("name: " + new String(name.getBytes("ISO-8859-1"), "utf-8") + "</br>");
        out.print("gender: " + new String(gender.getBytes("ISO-8859-1"), "utf-8") + "</br>");
        out.print("color: ");
        for (String s : color) {
            out.println(new String(s.getBytes("ISO-8859-1"), "utf-8"));
        }
        out.print("</br>");
        out.print("country: " + new String(country.getBytes("ISO-8859-1"), "utf-8") + "</br>");
    %>

    <%
        out.print("</br>---------------------方式三:利用URLDecoder进行解码-----------------------</br>");

        if (rawQueryString != null) {
            String queryString = URLDecoder.decode(rawQueryString, "utf-8");
            out.print("解码后的字符串 : " + queryString);

            String[] queryParams = queryString.split("&");

            out.print("name: " + queryParams[0].split("=")[1] + "</br>");
            out.print("gender: " + queryParams[1].split("=")[1] + "</br>");
            out.print("color: ");
            for (String s : queryParams) {
                if(s.split("=")[0].equals("color"))
                    out.println(s.split("=")[1]);
            }
            out.print("</br>");
            out.print("country: " + queryParams[queryParams.length-1].split("=")[1] + "</br>");
        } 
    %>
</body>
</html>

运行结果如下图所示:

            GET表单实例结果.png-55.1kB


3、GET 请求的请求参数为中文情形小结

  只要我们以GET形式提交请求,无论是以表单形式提交还是以URL形式提交,如果参数中存在中文字符,那么我们必须进行相应的转码(借助String类)或者解码(借助URLDecoder类),关于 URLDecoder 的详细介绍见我的博文《使用 URLDecoder 和 URLEncoder 对中文进行编码和解码》。特别地,有五点需要注意:

  • request.getQueryString() 所返回的原生查询字符串只适用于 GET请求 ,若对 POST请求 使用,则返回 null;

  • 利用 URLDecoder 进行解码时,必须先对原生查询字符串解码,而后获取各请求参数。如果先获取各个请求参数,再依次解码,则仍是乱码;

  • 使用String进行 转码时,往往都是先从 ISO-8859-1 格式的字符串中取出字节内容,然后再用页面相应的编码格式重新构造一个新的字符串,像本示例(new String(country.getBytes(“ISO-8859-1”), “utf-8”))中的 一样。这样就可以支持中文字符的正常取值和显示;

  • 利用 URLDecoder 进行解码时,所采用的解码字符集取决于浏览器(本文所有实验都是基于 Google Chrome 的)。对于中文环境而言,一般要么是 UTF-8,要么是 GBK ;

  • 对于 GET请求,语句 request.setCharacterEncoding(“utf-8”); 对避免中文参数乱码起不到任何作用。

      
     经过上面的处理,GET请求的中文参数乱码问题已经得到解决。但是如果上面的表单中的输入项不止几项,那么每个输入项都需要进行编码转换,那样就很麻烦了。这时,我们就用到了大名鼎鼎的过滤器 filter 了。


三. POST 请求的请求参数为中文情形

  一般地,我们以POST形式提交请求,都是以表单形式进行并且 form 的 method 属性为 post。下面的示例对上面的示例做了一些修改,也由 “收集参数的表单页” 和 “表单提交参数显示页” 两部分构成:

收集参数的表单页:

<%@ page contentType="text/html; charset=utf-8" language="java"
    pageEncoding="utf-8" errorPage=""%>
<head>
<title>收集参数的表单页</title>
</head>
<body>
    <form id="form" action="request1.jsp" method="post">
        用户名:<br /> <input type="text" name="name"><hr /> 性别:<br /> 男:<input
            type="radio" name="gender" value="男"> 女:<input type="radio"
                name="gender" value="女"><hr /> 喜欢的颜色:<br /> 红:<input
                    type="checkbox" name="color" value="红"> 绿:<input
                        type="checkbox" name="color" value="绿"> 蓝:<input
                            type="checkbox" name="color" value="蓝"><hr /> 来自的国家:<br />
                                <select name="country">
                                    <option value="中国">中国</option>
                                    <option value="美国">美国</option>
                                    <option value="俄罗斯">俄罗斯</option>
                            </select>
                            <hr />
        <input type="submit" value="提交">
        <input type="reset" value="重置">
    </form>
</body>
</html>

表单提交参数显示页:

<%@ page language="java" import="java.util.*,java.net.*"
    contentType="text/html; charset=utf-8" pageEncoding="utf-8"
    errorPage=""%>
<html>
<head>
<title>表单提交中文乱码</title>
</head>
<body>

    <%! private String rawQueryString = null;  %>

    <%
        /* 对于post请求,该语句为避免中文参数乱码起到关键作用 */
        request.setCharacterEncoding("utf-8");

        String name = request.getParameter("name");
        String gender = request.getParameter("gender");
        String[] color = request.getParameterValues("color");
        String country = request.getParameter("country");

        out.print("---------------------原生查询字符串-----------------------</br>");
        rawQueryString = request.getQueryString();
        out.print(rawQueryString + "</br>");
    %>

    <%
        out.print("</br>---------------------方式一:直接打印请求参数-----------------------</br>");
        out.print("name: " + name + "</br>");
        out.print("gender: " + gender + "</br>");
        out.print("color: ");
        for (String s : color) {
            out.println(s);
        }
        out.print("</br>");
        out.print("country: " + country + "</br>");
    %>

    <%
        out.print("</br>---------------------方式二:利用String进行转码-----------------------</br>");

        out.print("name: " + new String(name.getBytes("ISO-8859-1"), "utf-8") + "</br>");
        out.print("gender: " + new String(gender.getBytes("ISO-8859-1"), "utf-8") + "</br>");
        out.print("color: ");
        for (String s : color) {
            out.println(new String(s.getBytes("ISO-8859-1"), "utf-8"));
        }
        out.print("</br>");
        out.print("country: " + new String(country.getBytes("ISO-8859-1"), "utf-8") + "</br>");
    %>

    <%
        out.print("</br>---------------------方式三:利用URLDecoder进行解码-----------------------</br>");

        if (rawQueryString != null) {
            String queryString = URLDecoder.decode(rawQueryString, "utf-8");
            out.print("解码后的字符串 : " + queryString);

            String[] queryParams = queryString.split("&");

            out.print("name: " + queryParams[0].split("=")[1] + "</br>");
            out.print("gender: " + queryParams[1].split("=")[1] + "</br>");
            out.print("color: ");
            for (String s : queryParams) {
                if(s.split("=")[0].equals("color"))
                    out.println(s.split("=")[1]);
            }
            out.print("</br>");
            out.print("country: " + queryParams[queryParams.length-1].split("=")[1] + "</br>");
        } 
    %>
</body>
</html>

运行结果如下图所示:

            POST表单参数.png-32.1kB


  根据上面运行结果,我们知道: 对于POST请求,若其请求参数包含中文字符,那么我们只需在解析请求参数前加一句如下的代码即可。需要注意的是,这种方式对 Get请求起不到任何作用。此外,由于我们对请求已经重新编码,所以已经不需要使用 String类 再进行转码,否则画蛇添足。最后,对于 POST请求,request.getQueryString(); 返回的查询字符串为 null。

request.setCharacterEncoding("utf-8");

四. 总结

  本文首先从四个方面给出了在使用JSP过程中可能出现中文乱码的情形,具体包括JSP页面中文乱码、JSP源文件中文乱码、GET 请求的请求参数为中文乱码 和POST 请求的请求参数为中文乱码四种情形,并针对每种情形给出了相应的终极解决方案。

  更多关于 JSP技术的细节见我的其他两篇博客: 《Java Web基础 — Jsp 综述(上)》《Java Web基础 — Jsp 综述(下)》

  更多关于 JSP中文乱码问题的解决方案见我的另一篇博客:《 JSP中文乱码问题终极解决方案(上)》


引用

JSP中文乱码问题终极解决方案

已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页