JSP包含指令include包含html文件出现乱码分析与解决

  昨天上课的时候,忽然发现在JSP文件中使用静态包含指令<%@ include file="**.html"%>包含html文件的时候,被包含的html文件的中不能出现中文,一出现中文字体,就是一个字,乱,两个字,乱码.

  在网上找了一通,发现没有几个能解释的清楚的,都只是片面得讲解决方法,并且有的并不好用,所以决定彻底弄清楚,经过实验,终于有了结果.刚对该问题总结了一下,发现出现的问题原因应该是,静态包含指令是在jsp文件执行之前将被包含文件包含进来,如果被包含文件里面没有使用明确的指令说明它的编码方式是什么,一般我发现是使用utf-8编码,这样如果这里需要说明一下pageEncoding与contentType两种属性:

关于JSP页面中的pageEncoding和contentType两种属性的区别：

pageEncoding是jsp文件本身的编码

contentType的charset是指服务器发送给客户端时的内容编码

本文为原创作品,转载请注明:来自http://www.historycreator.com

JSP要经过两次的“编码”，第一阶段会用pageEncoding，第二阶段会用utf-8至utf-8，第三阶段就是在客户端浏览器里看到的网页， 用的是contentType。

第一阶段是jsp编译成.java，它会根据pageEncoding的设定读取jsp，结果是由指定的编码方案翻译成统一的UTF-8 JAVA源码（即.java），如果pageEncoding设定错了，或没有设定，出来的就是中文乱码。

第二阶段是由JAVAC的JAVA源码至java byteCode的编译，不论JSP编写时候用的是什么编码方案，经过这个阶段的结果全部是UTF-8的encoding的java源码。

JAVAC用UTF-8的encoding读取java源码，编译成UTF-8 encoding的二进制码（即.class），这是JVM对常数字串在二进制码（java encoding）内表达的规范。

第三阶段是Tomcat（或其的application container）载入和执行阶段二的来的JAVA二进制码，输出的结果，也就是在客户端见到的，这时隐藏在阶段一和阶段二的参数contentType就发挥了功效

而include指令就是在第一阶段之前执行的,注意这个是在第一阶段之前,所以,如果包含文件和被包含文件的文件编码不是utf-8,那么,该指令就会工作不太正常,不能正确的把被包含的文件从原来编码转换为包含文件的编码,就会出现乱码现象.

  解决的方法有很多,一种很简单的方法就是,把包含文件的pageEncoding设置为utf-8,同时,把被包含文件的pageEncoding也设置为utf-8,如果被包含文件为html的话,如果你使用的ide是eclipse的话,那么,可以这么做,在被包含文件名上右键单击,选择属性 (properties),Resource下,在text file encoding里选择utf-8,这样就可以做到正常显示了.如果用的是其他的编辑工具,比如Dream weaver,也有响应的修改页面编码的地方.
另外一种方法比较麻烦点,但是也挺好用,支持各种编码方式,只需要修改web.xml文件就可以了.

方法为:在web.xml里添加(注意我所使用的javaee版本2.5为
<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" id="WebApp_ID" version="2.5">)

<jsp-config>
<jsp-property-group>
 <description>jsp encoding example</description>
 <display-name>JSPConfiguration</display-name>
 <url-pattern>*.jsp</url-pattern>
 <el-ignored>true</el-ignored>
 <page-encoding>gbk</page-encoding>
 <scripting-invalid>false</scripting-invalid>
 <include-prelude></include-prelude>
 <include-coda></include-coda>
</jsp-property-group>
<jsp-property-group>
 <description>html encoding example</description>
 <display-name>JSPConfiguration</display-name>
 <url-pattern>*.html</url-pattern>
 <el-ignored>true</el-ignored>
 <page-encoding>gbk</page-encoding>
 <scripting-invalid>false</scripting-invalid>
 <include-prelude></include-prelude>
 <include-coda></include-coda>
</jsp-property-group>
</jsp-config>

需要注意的是,这里设置的page-encoding必须与真正的被包含文件和包含文件的pageEncoding一致,修改方法见上一方法.

本文为原创作品,转载请注明:来自http://www.historycreator.com

2009-10-18夜于HIT.