Tomcat5+Mysql中文乱码问题的解决方法

Tomcat 下最容易到的问题就是中文乱码问题了,下面就来谈谈我在Windows +Tomcat5下调试JSP程序时,所碰到的问题以及解决办法。

这次调试所遇到的乱码问题主要有三类：

一、页面字符乱码。

即整个页面出现汉字乱码（不管是用HTML格式写的，还是用print()方法输出的汉字，全部显示为乱码）。

二、Request 传递乱码。

在用post，get等方法，传递变量时出现乱码；需要进行cookies或者session调用时出现乱码。

三、数据库存取乱码。

在进行数据库存取时，或者存入数据库，或者读出数据时出再乱码。

下面就这三类乱码进行分析并谈谈我的解决方法：

一、页面字符乱码。

我们先写下这样的一个jsp文件：

//testPagErr.jsp

<%

out.println(“能显示中文吗？”);

%>

如果我们直接按照默认的配置启动Tomcat5，然后访问这一个页面的时，将输出的中文将显示为乱码。其原因很简单，这是由于在Tomcat5 默认的设置下，将按照ISO-8859-1进行编码。解决这个问题最直接的做法是，有每个有中文输出的jsp文件的开头加一句：

<%@ page contentType="text/html;charset=GBK" //（改成GB2312亦可，本文中均以GBK为例）%>

但是这样做存在很多问题，首先，这一句开指令在include的时候，不能够被子文件继承，因此，我们必须在子文件中重新加入这一句话，但如果大小写不话，就会出现类似于以下的错误：

org.apache.jasper.JasperException: /top.jsp(1,1) Page directive: illegal to have multiple occurrences of contentType with different values (old: text/html;charset=gbk, new: text/html;charset=GBK).

那么,这样子定义就有点恐怖了，假如有一个要作Head.jsp的头文件，我们试着在其中加入<%@ page contentType="text/html;charset=GBK" %>，要在众多的文件中被包含，而这些文件是由不同的程序只写的，有的习惯用“gbk”,有的用“GBK”，还有喜欢用“GB<chmetcnv w:st="on" tcsc="0" numbertype="1" negative="False" hasspace="False" sourcevalue="2312" unitname="”">2312<span lang="EN-US" style="font-family: 宋体;"><span lang="EN-US">”</span></span></chmetcnv>，那怎么办啊？难到要一个文件一个文件地去改过来？就算你可以用一些编辑器的Replace in Files功能把所有的文件更正过来，但这样做必然会影响系统的可移植性。

同样,如果"text/html;charset=GBK"的间隔不一致的话，也会出错，而且，一旦程被修改成这样的模式，你的程序就不能在旧的jsp/servlet container上执行了，因为旧的规格是不允许在include文档中再次中现<%@ page ... %>这样的定义的。

因此上，如果采用上述方法的话，在一两个页面上也可行，但此法仅为权益之计。

在J2EE1.4中，关于jsp的部分里有一个<jsp-config> 的 XML Tag，这个区块是用来定义jsp的相关特殊属性的，它包含所采用的taglib和下面我们要用到的<jsp-property-group>，定义字符编码的方法就定义在<jsp-property-group>之中，找到你正在开发的webapps目录（一般在$TOMCAT_HOME\webapps\your_web_site\）下的WEB-INF，打开web.xml(如果没的话，就创建一个)，作如下修改：

<?xml version="1.0" encoding="ISO-8859-1"?>

<!— 这一段是xml　head的定义，特别注意，最后的version="2.4"，Tomcat５会去检测这个版本的信息，只有2.4的才会去处理jsp-config中的参数 -->

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web-app_2_4.xsd"

version="2.4">

<!— ------------------------------------------------------------------------------------------ -->

<!— 这一部分就是我们新加入的，起作用的区块 -->

<jsp-config>

<jsp-property-group>

<description>

Special property group for JSP Configuration JSP example.

</description>

<display-name>JSPConfiguration</display-name>

<url-pattern>*.jsp</url-pattern>

<el-ignored>true</el-ignored>

<page-encoding>GBK</page-encoding>

<scripting-invalid>flase</scripting-invalid>

<include-prelude></include-prelude>

<include-coda></include-coda>

<description>

Special property group for JSP Configuration JSP example.

</description>

<display-name>JSPConfiguration</display-name>

<url-pattern>*.html</url-pattern>

<el-ignored>true</el-ignored>

<page-encoding>GBK</page-encoding>

<scripting-invalid>flase</scripting-invalid>

<include-prelude></include-prelude>

<include-coda></include-coda>

</jsp-property-group>

</jsp-config>

<!— ------------------------------------------------------------------------------------------ -->

</web-app>

另外，如果Tomcat5与Apache整和，最好把httpd.conf中的AddDefaultCharset的值设为GBK.

二、Ｒequest传递乱码。

按照Tomcat的默认设置，在通过表单提交的数据将出现乱码，其原因是中文字符的高位被丢失，如：

成龙的unicode是 6210 9f99 ，但是从request里面读出来的是： 10 99。

其原因是form表单和request方法中设置的编码格式不一致，在上面，我们已经将页面编码改成了GBK，因此上，我们只须将request的编码改为GBK即可。

比较简单的解决方法是，在要用到request方法的地方加上这条语句：request.setCharacterEncoding("GBK");

但这也将遇到与第一种方法同样，当几个人同时写程序时，或者，引用别人已写的程序的时候，也会存在移植不便的问题。

更好的方法是，注册SetCharacterEncodingFilter类：

在$TOMCAT_HOME\webapps\your_web_site\WEB-INF\classes目录下新建一个名为filters的文件夹，然后把$TOMCAT_HOME\webapps\jsp-examples\WEB-INF\classes\filters的SetCharacterEncodingFilter.class文件拷到新建的filters下面，最后在web.xml中加入如下的两个区块：

<!-- Example filter to set character encoding on each request -->

<filter>

<filter-name>Set Character Encoding</filter-name>

<filter-class>filters.SetCharacterEncodingFilter</filter-class>

<init-param>

<param-name>encoding</param-name>

<param-value>GBK</param-value>

</init-param>

</filter>

<!-- Example filter mapping to apply the "Set Character Encoding" filter

to *all* requests processed by this web application -->

<filter-mapping>

<filter-name>Set Character Encoding</filter-name>

<url-pattern>/*</url-pattern>

</filter-mapping>

如果找不到SetCharacterEncodingFilter.class，也可以自己编写SetCharacterEncodingFilter.java文件，代码如下：

／*

* filename: SetCharacterEncodingFilter.java

*／

package filters;

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;

import javax.servlet.UnavailableException;

public class SetCharacterEncodingFilter implements Filter {

protected String encoding = null;

protected FilterConfig filterConfig = null;

protected boolean ignore = true;

public void destroy() {

this.encoding = null;

this.filterConfig = null;

}

public void doFilter(ServletRequest request, ServletResponse response,

FilterChain chain)

throws IOException, ServletException {

// Conditionally select and set the character encoding to be used

if (ignore || (request.getCharacterEncoding() == null)) {

String encoding = selectEncoding(request);

if (encoding != null)

request.setCharacterEncoding(encoding);

}

// Pass control on to the next filter

chain.doFilter(request, response);

}

public void init(FilterConfig filterConfig) throws ServletException {

this.filterConfig = filterConfig;

this.encoding = filterConfig.getInitParameter("encoding");

String value = filterConfig.getInitParameter("ignore");

if (value == null)

this.ignore = true;

else if (value.equalsIgnoreCase("true"))

this.ignore = true;

else if (value.equalsIgnoreCase("yes"))

this.ignore = true;

else

this.ignore = false;

}

// ------------------------------------------------------ Protected Methods

protected String selectEncoding(ServletRequest request) {

return (this.encoding);

}

}

用任意一个java编译器编译即可，编译的时候注意包含servlet-api.jar包，它位于$TOMCAT_HOME\common\lib\下面。

然后删除work中的内容，然后启动Tomcat，即可显示中文了。

三、数据库存取乱码

当然，在写数据库时，也要保正数据库的编码与其它一致：

我们可以在系统盘windows目录下的my.ini文件，在文件中插入一行default-character-set=GBK,但上面说了这么多，大家也应该明白些了吧，改动太多的默认设置不是我的风格，因此上，这一行还是不要加的好。

但不管怎么样，我们还是要创建一个基于中文编码的数据库，当然，用客户端登录的时候，某些客户用自动把字体编码转换成中文编码。在这里，我想说一下在DOS下创建中文编码数据库的方法：

在进入数据库的时候，用mysql--default-character-set=gbk-uroot-p这句话进入mysql，然后创建数据库，如：createdatabaseadmin;这样创建起来的数据库就是基于中文编码的了。

用连接数据库的时候，读出的数据也可能是乱码，解决这个问题的方法非常简单，只要在你建立数据库连接的时候把URL设置成下面这个样子就可以了：URL=jdbc:mysql://localhost:3306/my_database?useUnicode=true&characterEncoding=GBK

好了，说了这么多，总结一句话结束吧，把各种地方的编码统一起来，那么，所在的乱码问题就都解决了！