dom4j使用基本指南

dom4j是一个简单的、灵活的开放源代码的库，支持XML、XPath和XSLT。与JDOM一样，dom4j也应用于Java平台。dom4jAPI使用了Java集合框架并完全支持DOM、SAX和JAXP。 

dom4j是由早期开发JDOM的人分离出来而后独立开发的。与JDOM不同的是，dom4j使用接口和抽象基类，虽然dom4j的API相对要复杂一些，但它提供了比JDOM更好的灵活性。 

dom4j是一个非常非常优秀的Java XMLAPI，具有性能优异、功能强大和极端易用使用的特点，同时它也是一个开放源代码的软件。 

dom4j API介绍 

dom4j-1.6.1API共有14个包，其中org.dom4j包中包括了表示XML文档组成部分的接口，org.dom4j.io包中包括了构建dom4j文档树的类，以及输出dom4j文档树的类。 

(1)创建XML文档 
在org.dom包中提供了一个DocumentHelper类，该类中多有的方法都是静态方法，其中就包括了创建XML文档各个组成部分的方法。 

Documentdoc=DocumentHelper.createDocument(); 
ElementeltRoot=DocumentHelper.createElement_x("student"); 
doc.setRootElement(eltRoot); 

也可以先创建跟元素对象，然后在创建文档对象的同时制定根元素，如下： 

ElementeltRoot=DocumentHelper.createElement_x("student"); 
Documentdoc=DocumentHelper.createDocument(eltRoot); 

(2)添加属性 
在dom4j中，添加属性与JDOM一样简单，如下： 

eltRoot.addAttribute("sn","01"); 

(3)增加子元素以及设置元素内容 
在Branch接口中，定义了addElement()方法，如下： 

public Element addElement(String name) 

该方法用指定的name为当前节点添加一个子元素节点，并返回新节点的引用。我们使用这个方法，为根元素添加子元素，如下： 

Element eltName=eltRoot.addElement("name"); 
Element eltAge=eltRoot.addElement("age"); 
eltName.setText("awang"); 
eltAge.setText("22"); 

(4)输出文档 
dom4j提供了XML文档的多种输出形式。在org.dom4j.io包中，DOMWriter类可以将dom4j树输出为W3CDOM的Document对象，SAXWriter类可以将dom4j树作为SAX事件流输出，而XMLWriter类则提供了将dom4j树的各个部分以XML流的方式输出的能力。 
例如，下面的代码将创建的XML文档输出到屏幕上： 

XMLWriter xmlWriter=new XMLWriter(); 
xmlWriter.write(doc); 

你也可以选择输出到文件中，如下： 

XMLWriter xmlWriter=new XMLWriter(newjava.io.FileWriter("student.xml")); 
xmlWriter.write(doc); 
xmlWriter.close(); 

dom4j还提供了控制文档输出格式的类org.dom4j.io.OutputFormat。利用这个类可以设置输出文档的字符编码、设置行分隔符、缩进字符串等。 
下面的代码设置输出格式使用4个空格作为缩进字符串，元素之间添加新行。 

OutputFormat outFmt=newOutputFormat("   ",true); 
XMLWriter xmlWriter=new XMLWriter(outFmt); 
xmlWriter.write(doc); 

下面的代码使用美化的格式输出文档，设置字符编码为GB2312，并使用4个空格作为缩进。 

OutputFormatoutFmt=OutputFormat.createPrettyPrint(); 
outFmt.setEncoding("GB2312"); 
outFmt.setIndent("   "); 
XMLWriter xmlWriter=new XMLWriter(outFmt); 
xmlWriter.write(doc); 

(5)构建dom4j树 
dom4j在org.dom4j.io包中，提供了两个类：DOMReader和SAXReader，DOMReader从一个现有的W3CDOM树构建dom4j树，而SAXReader则使用SAX解析器，从不同的输入源来构建dom4j树。 
以SAXReader类来构建dom4j来构建dom4j文档对象的代码如下： 

SAXReader saxReader=new SAXReader(); 
File file=new File("student.xml"); 
Document doc=saxReader.read(file); 

(6)访问根元素 
在Document类中，给出了getRootElement()方法，用于返回文档的根元素。如下： 

Element root=doc.RootElement(); 

(7)访问节点 
要得到某个元素的所有子元素，如下： 

java.util.List childrenList=elt.elements(); 

要得到某个元素的具有给定名称的所有子元素，如下： 

java.util.ListchildrenList=elt.elements("student"); 

要得到某个元素的具有给定名称的第一个字元素，如下： 

Element eltChild=elt.element("student"); 

要迭代某个元素的所有子元素，如下： 

for(java.util.Iteratorit=root.elementIterator();it.hasNext();) 
{ 
    Elementelement=(Element)it.next(); 
} 

要删除某个元素，可以用Branch接口中定义的remove()方法，如下： 

Element eltStu=root.element("student"); 
root.remove(eltStu); 

(8)访问属性 
要得到某个元素的所有属性，如下： 

java.util.List sttrList=elt.attributes(); 

要得到指定的属性，如下： 

Attribute attr=elt.attribute("sn"); 

要得到某个属性的值，如下： 

String attrValue=elt.attributeValue("sn"); 

要删除某个属性，如下： elt.remove(elt.attribute("sn"));