dom4j的使用及常见问题

相信作为一个开发人员应该对XML与JSON 非常熟悉。关于两者的介绍与区别网上已经有很多资料，java对于XML的解析也有很多工具包，主要解析的方式有三种：

1.DOM解析方式：适用于解析小型XML文件，如果操作大型XML文件，将整个Docment读入内存可能会引起内存不足。

2.SAX解析方式：对内存占用较小，适合解析大型XML文件，说白了就是扫描解析。

3.Digester/JAXB： Struts 的 XML 解析工具 Digester。

本文主要介绍dom4j的使用，dom4j中已经整合了SAX方式。使用dom4j可以应对大型XML文件的操作。对于Digester笔者没有过多的接触，这里就不做过多的说明。

下面来看dom4j的使用。

一.登录官网http://www.dom4j.org/

如果找不到下载位置可以去github下载 （http://dom4j.github.io/）

二.将下载的压缩包解压。会看到（dom4j-1.6.1.jar）包，将jar包导入工程便可。

三.简单的读写操作，以下是操作代码：

public class XMLTest {  
    String fileName = "d:/test/test.xml";  
    @Test  
    public void testWriteXML(){  
        try {  
            OutputFormat format = OutputFormat.createPrettyPrint();//创建格式化类  
            format.setEncoding("UTF-8");//设置编码  
            format.setIndent(true);//是否缩进  
            format.setNewlines(true);//是否换行  
            XMLWriter xmlWriter = new XMLWriter(new FileWriter(fileName), format);  
            //如果需要设置文件编码格式，则需要使用一下方式创建writer   (1)  
            //xmlWriter = new XMLWriter(new OutputStreamWriter(new FileOutputStream(new File(fileName)), "UTF-8"), format);  
            Document document = DocumentHelper.createDocument();//通过DocumentHelper工具类创建document  
            Element root = document.addElement("root");  
            root.addElement("item").addAttribute("type", "t").addText("text");  
            xmlWriter.write(document);  
            xmlWriter.close();//一定要关闭 (2)  
        } catch (IOException e) {  
            e.printStackTrace();  
        }  
    }  
//  @Test  
    public void testReadXML(){//将XML文件一次性读取  
        SAXReader reader = new SAXReader();  
        try {  
            Document document = reader.read(new FileReader(fileName));  
            Element root = document.getRootElement();  
            for(Iterator<?> i = root.elementIterator(); i.hasNext();){//遍历节点  
                Element ele = (Element) i.next();  
                System.out.println(ele.asXML());  
            }  
        } catch (FileNotFoundException e) {  
            e.printStackTrace();  
        } catch (DocumentException e) {  
            e.printStackTrace();  
        }  
    }  
  
        @Test  
    public void testWriteXML1(){//写入较大XML文件时，建议使用以下方式  
        try {  
            OutputFormat format = OutputFormat.createPrettyPrint();  
            format.setEncoding("UTF-8");//设置编码  
            format.setIndent(true);//是否缩进  
            format.setNewlines(true);//是否换行  
            XMLWriter xmlWriter = new XMLWriter(new FileWriter(fileName), format);  
            Document document = DocumentHelper.createDocument();//通过DocumentHelper工具类创建document  
            xmlWriter.write(document);  
            Element root = document.addElement("root");  
            Element item = DocumentHelper.createElement("item");  
            xmlWriter.writeOpen(root);//准备写入  
            for(int i=0;i<1000000;i++){  
                item.addAttribute("type", "type"+i).addText("text"+i);  
                item.setParent(root);  
                xmlWriter.write(item);//写入节点  
                item.clearContent();//清空节点属性  
            }  
            xmlWriter.writeClose(root);//写入完成  
            xmlWriter.close();//一定要关闭  
        } catch (IOException e) {  
            e.printStackTrace();  
        }  
    }  
    @Test  
    public void testSAXReader(){//扫描方式读取XML文件,需要实现ElementPath 接口，在该接口中进行逻辑处理  
        SAXReader reader = new SAXReader();  
        reader.setDefaultHandler(new ElementHandler() {  
            @Override  
            public void onStart(ElementPath elementPath) {  
                Element element = elementPath.getCurrent();  
                if("item".equals(element.getName())){  
                    System.out.println(element.attributeValue("type"));  
                    System.out.println(element.getText());//没有获取Text值(3)  
                }  
            }  
              
            @Override  
            public void onEnd(ElementPath elementPath) {  
                Element element = elementPath.getCurrent();  
                if("item".equals(element.getName())){  
                    System.out.println(element.attributeValue("type"));  
                    System.out.println(element.getText());  
                }  
            }  
        });  
        try {  
            reader.read(new FileReader(fileName));  
        } catch (FileNotFoundException e) {  
            e.printStackTrace();  
        } catch (DocumentException e) {  
            e.printStackTrace();  
        }  
    }  
}

四：注意事项：

（1）：生成XML文件编码，如果有中文需要注意此处配置。

（2）：一定记得关闭write。

（3）：ElementHandler接口，需要实现onStart（初始化操作），onEnd方法（处理逻辑），这里注意在onStart方法中将无法获得节点的Text值（可能是没有读完操作）。

注明：如果需要更详细的介绍，请参考官方文档

参考：http://www.ibm.com/developerworks/cn/xml/dm-1208gub/