DOM4J介绍与代码示例（一）

v\:* {behavior:url(#default#VML);} o\:* {behavior:url(#default#VML);} w\:* {behavior:url(#default#VML);} .shape {behavior:url(#default#VML);} st1\:*{behavior:url(#ieooui) }

DOM4J 是 dom4j.org 出品的一个开源 XML 解析包。 Dom4j 是一个易用的、开源的库，用于 XML ， XPath 和 XSLT 。它应用于 Java 平台，采用了 Java 集合框架并完全支持 DOM ， SAX 和 JAXP 。

DOM4J 下载 jar 包： http://downloads.sourceforge.net/dom4j/dom4j- 1.6.1 .jar

JAXEN （对 XPath 的支持）： http://dist.codehaus.org/jaxen/distributions/jaxen- 1.1.1 .zip

1.DOM4J 主要接口

DOM4J 主要接口都在 org.dom4j 这个包里定义。

 

 

-Node 为所有的 dom4j 中 XML 节点定义了多态行为；

 

-Branch 为能够包含子节点的节点如 XML 元素 (Element) 和文档 (Docuemnts) 定义了一个公共的行为；

|-Element 定义 XML 元素；

|-Document 定义了 XML 文档；

 

-DocumentType 定义 XML DOCTYPE 声明；

-Entity 定义 XML entity ；

-Attribute 定义了 XML 的属性；

-ProcessingInstruction 定义 XML 处理指令；

 

-CharacterData 是一个标识借口，标识基于字符的节点。如 CDATA ， Comment, Text ；

|- CDATA 定义了 XML CDATA 区域；

|-Text 定义 XML 文本节点；

|- Comment 定义了 XML 注释的行为；

2. 创建 XML 文档

示例 xml ： students.xml

<? xml version="1.0" encoding="UTF-8"?> <? xml-stylesheet type="text/xsl" href="students.xsl"?> < students >     <!--A Student Catalog-->     < student sn="01">        < name > sam </ name >        < age > 18 </ age >     </ student >     < student sn="02">        < name > lin </ name >        < age > 20 </ age >     </ student > </ students >

 

下面是用 dom4j 创建上述文档，通过两种方式创建，一种是调用 dom4j 提供的方法，一种是通过字符串转换。

XmlGen.java

import java.io.File; import java.io.FileWriter; import java.io.IOException; import java.util.HashMap; import java.util.Map;   import org.dom4j.Document; import org.dom4j.DocumentException; import org.dom4j.DocumentHelper; import org.dom4j.Element; import org.dom4j.io.XMLWriter;   public class XmlGen {     public Document generateDocumentByMethod() {        Document document = DocumentHelper.createDocument();        // ProcessingInstruction        Map<String, String> inMap = new HashMap<String, String>();        inMap.put( "type" , "text/xsl" );        inMap.put( "href" , "students.xsl" );        document.addProcessingInstruction( "xml-stylesheet" , inMap);        // root element        Element studentsElement = document.addElement( "students" );        studentsElement.addComment( "An Student Catalog" );        // son element        Element stuElement = studentsElement.addElement( "student" );        stuElement.addAttribute( "sn" , "01" );        Element nameElement = stuElement.addElement( "name" );        nameElement.setText( "sam" );        Element ageElement = stuElement.addElement( "age" );        ageElement.setText( "18" );        // son element        Element anotherStuElement = studentsElement.addElement( "student" );        anotherStuElement.addAttribute( "sn" , "02" );        Element anotherNameElement = anotherStuElement.addElement( "name" );        anotherNameElement.setText( "lin" );        Element anotherAgeElement = anotherStuElement.addElement( "age" );        anotherAgeElement.setText( "20" );          return document;     }       public Document generateDocumentByString() {        String text = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +               "<?xml-stylesheet type=\"text/xsl\" href=\"students.xsl\"?>" +               "<students><!--An Student Catalog-->   <student sn=\"01\">" +               "<name>sam</name><age>18</age></student><student sn=\"02\">" +               "<name>lin</name><age>20</age></student></students>" ;        Document document = null ;        try {            document = DocumentHelper.parseText(text);        } catch (DocumentException e) {            e.printStackTrace();        }        return document;     }       public void saveDocument(Document document, File outputXml) {        try {            // 美化格式            OutputFormat format = OutputFormat.createPrettyPrint();            /*// 缩减格式            OutputFormat format = OutputFormat.createCompactFormat();*/            /*// 指定 XML 编码             format.setEncoding("GBK");*/            XMLWriter output = new XMLWriter( new FileWriter(outputXml), format);            output.write(document);            output.close();        } catch (IOException e) {            System. out .println(e.getMessage());        }     }       public static void main(String[] argv) {        XmlGen dom4j = new XmlGen();        Document document = null ;        // document=dom4j.generateDocumentByMethod();        document = dom4j.generateDocumentByString();        dom4j.saveDocument(document, new File( "output.xml" ));     } }

方法 generateDocumentByMethod() 通过调用方法构建 xml 文档：

1. 使用 DocumentHelper 得到 Document 实例

Document document = DocumentHelper.createDocument();

2. 创建 Processing Instruction

document.addProcessingInstruction( "xml-stylesheet" , inMap);

3. 创建元素 Element

Element studentsElement = document.addElement( "students" );

4. 为元素添加注释 Comment

studentsElement.addComment( "An Student Catalog" );

5. 为元素添加属性

studentsElement.addComment( "An Student Catalog" );

6. 为元素添加文本值 Text

ageElement.setText( "18" );

 

方法 generateDocumentByString() 通过字符串转换直接构建 xml 文档，使用 DocumentHelper.parseText() 来实现 .

document = DocumentHelper.parseText(text);

 

方法 saveDocument(Document document, File outputXml) 将文档输出到文件保存，可指定字符编码，可指定格式化输出。

3. 修改 XML 文档

这里使用 xpath 来定位待修改的元素和属性，需要 jaxen 的支持。

示例中将 students-gen.xml 的第一个 student 元素的 sn 属性改为 001 ，其子元素 name 内容改为 jeff 。

XmlMod.java

import java.io.File; import java.io.FileWriter; import java.io.IOException; import java.util.Iterator; import java.util.List;   import org.dom4j.Attribute; import org.dom4j.Document; import org.dom4j.DocumentException; import org.dom4j.Element; import org.dom4j.io.SAXReader; import org.dom4j.io.XMLWriter;   public class XmlMod {     public void modifyDocument(File inputXml) {        try {            SAXReader saxReader = new SAXReader();            Document document = saxReader.read(inputXml);            List list = document.selectNodes( "//students/student/@sn" );            Iterator iter = list.iterator();            while (iter.hasNext()) {               Attribute attribute = (Attribute) iter.next();               if (attribute.getValue().equals( "01" ))                   attribute.setValue( "001" );            }              list = document.selectNodes( "//students/student" );            iter = list.iterator();            while (iter.hasNext()) {               Element element = (Element) iter.next();               Iterator iterator = element.elementIterator( "name" );               while (iterator.hasNext()) {                   Element nameElement = (Element) iterator.next();                   if (nameElement.getText().equals( "sam" ))                      nameElement.setText( "jeff" );               }            }              XMLWriter output = new XMLWriter( new FileWriter( new File(                   "students-modified.xml" )));            output.write(document);            output.close();        }          catch (DocumentException e) {            System. out .println(e.getMessage());        } catch (IOException e) {            System. out .println(e.getMessage());        }     }       public static void main(String[] argv) {        XmlMod dom4jParser = new XmlMod();        dom4jParser.modifyDocument( new File( "students-gen.xml" ));     } }