【原创】JDom输出UTF-8的XML完美解决(中文乱码的原因分析)

JDom输出UTF-8的XML完美解决（中文乱码的原因分析）

现象描述：JDom输出Xml文件，当使用字符编码GBK时正常，而输出UTF-8时乱码。

URL:http://blog.csdn.net/wangqiyy/archive/2008/07/02/2603666.aspx 

完美的解决方法从辟谣开始：

1）JDOM是否生成UTF-8的文件与Format是否设置无关，只有输出其他字符编码才需要设置，见下面的注释。

2）JDOM输出UTF-8文件乱码的根本原因并非在JDOMAPI，而是在JDK。

 

具体描述：

    JDOM的输出类XMLOutputter有两个output接口，除了都具有一个Document参数外，分别接受Writer和OutputStream参数。

    这给我们一个错觉，两个接口可以任意使用。

    首先我们用output(doc,System.out)来做测试，此时得到乱码，

      然后我们改为output(doc,new PrintWriter(System.out))来测试，输出不是乱码，

      也就是说在控制台的时候一定要用一个Writer接口包装一下。

    然后我们用output(doc,new FileWriter(path))来做测试，结果却得到乱码，

      然后我们改为output(doc,new FileOutputStream(path))来测试，输出不是乱码，

      也就是说在输出文件的时候一定要用一个OutputStream接口包装一下。

    疯了吧？呵呵，很搞笑是吧。经过到JDOM的源码中调试，发现没有任何问题，问题出在了JDK里面。

 

JDK内的对应接口处理：

1）PrintWriter类有参数为OutputStream的构造方法，因此可以从System.out包装到PrintWriter

2）FileWriter类没有参数为OutputStream的构造方法，因此不能从FileOutputStream包装到FileWriter

3）如果PrintWriter类用了参数为Writer的构造方法（Writer实现为FileWriter），最后输出也是乱码

4）如果用一个FileOutputStream来包装一个控制台输出，也是乱码

因此，对于JDK内的各种输出体系，各种InputStream、OutputStream、reader和writer要充分认识，否则极容易出现一些意想不到的问题。

 

 

测试的JDOM版本：1.0、1.1

测试代码： 

import java.io.File;

import java.io.FileOutputStream;

import java.io.FileWriter;

import java.io.PrintWriter;

import java.util.HashMap;

 

import org.jdom.Document;

import org.jdom.Element;

import org.jdom.output.Format;

import org.jdom.output.XMLOutputter;

 



public class BuildXML {

 

 public static void main(String[] args) throws Exception{

  

  File xmlfile=new File("C://EditTemp//xml//abc.xml");

  

  //中文问题 //GBK 是没有问题的，但UTF-8就是有问题的

  //原因：

  //1)对于磁盘文件，必须使用输出流 FileOutputStream

  //     FileWriter out=new FileWriter(xmlfile);会导致乱码 

  //2)对于控制台输出，则必须使用PrintWriter，如果直接使用System.out也会出现乱码

  //     PrintWriter out=new PrintWriter(System.out);

  

  FileOutputStream out=new FileOutputStream(xmlfile);

     

     Element eroot=new Element("root");

     eroot.addContent((new Element("code")).addContent("代码"));

     eroot.addContent((new Element("ds")).addContent("数据源"));

     eroot.addContent((new Element("sql")).addContent("检索sql"));

     eroot.addContent((new Element("order")).addContent("排序"));

     

     Document doc=new Document(eroot);

     

     XMLOutputter outputter = new XMLOutputter();

     

     //如果不设置format，仅仅是没有缩进，xml还是utf-8的，因此format不是必要的

     Format f = Format.getPrettyFormat();

     //f.setEncoding("UTF-8");//default=UTF-8 

     outputter.setFormat(f); 

     

     outputter.output(doc, out);

    

     out.close();

 }

}

===========================================================

王琦  系统架构师

国信朗讯科技网络技术有限公司

Guoxin Lucent Technologies

Network Technologies Co.,Ltd.