原文链接:http://blog.csdn.net/justloveyou_/article/details/55827718
摘要:
本文首先从四个方面给出了在使用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>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
上面这个JSP程序是在页面显示几句中文而且标题也是中文,运行后在浏览器中显示如图所示:
原因在于没有在JSP中指定 页面显示的编码,消除乱码的解决方案就是将上面代码中的page命令修改成如下所示即可:
<!-- 示例2 -->
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<html>
<head>
<title>JSP页面中文乱码</title>
</head>
<body>
中国<br>
<%="中国" %>
</body>
</html>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
再次运行中文正常显示,原理就是 向页面指定编码为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)如图所示:
修改后,对于在Eclipse/MyEclipse所创建的任何一个JSP源文件,其默认编码方式均为 UTF-8,例如:
如果不做上述修改,如果我们在Eclipse/MyEclipse中编辑的JSP中存在中文字符,那么当我们保存该页面时,会弹出以下对话框:
但是,我们如果我们提前按如上步骤设置后,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)如图所示:
这样,通过以上两步的设置,当我们在 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>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
运行结果如下图所示:
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>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
表单提交参数显示页:
<%@ 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>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
运行结果如下图所示:
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>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
表单提交参数显示页:
<%@ 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>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
运行结果如下图所示:
根据上面运行结果,我们知道: 对于POST请求,若其请求参数包含中文字符,那么我们只需在解析请求参数前加一句如下的代码即可。需要注意的是,这种方式对 Get请求起不到任何作用。此外,由于我们对请求已经重新编码,所以已经不需要使用 String类 再进行转码,否则画蛇添足。最后,对于 POST请求,request.getQueryString(); 返回的查询字符串为 null。
request.setCharacterEncoding("utf-8");
- 1
四. 总结
本文首先从四个方面给出了在使用JSP过程中可能出现中文乱码的情形,具体包括JSP页面中文乱码、JSP源文件中文乱码、GET 请求的请求参数为中文乱码 和POST 请求的请求参数为中文乱码四种情形,并针对每种情形给出了相应的终极解决方案。
更多关于 JSP技术的细节见我的其他两篇博客: 《Java Web基础 — Jsp 综述(上)》 和 《Java Web基础 — Jsp 综述(下)》。
更多关于 JSP中文乱码问题的解决方案见我的另一篇博客:《 JSP中文乱码问题终极解决方案(上)》。