Dom4j 用法简介
Dom4j is an easy to use, open source library for working with XML, XPath and XSLT on the Java platform using the Java Collections Framework and with full support for DOM, SAX and JAXP.
Dom4j 是一个易用的、开源的库，用于 XML ， XPath 和 XSLT 。它应用于 Java 平台，采用了 Java 集合框架并完全支持 DOM ， SAX 和 JAXP 。
它的主要接口都在 org.dom4j 这个包里定义：
| Attribute |
|
| Branch |
|
| CDATA |
|
| CharacterData |
|
| Comment |
|
| Document |
|
| DocumentType |
|
| Element |
|
| ElementHandler |
|
| ElementPath |
被 |
| Entity |
|
| Node |
|
| NodeFilter |
|
| ProcessingInstruction |
|
| Text |
|
| Visitor |
|
| XPath |
|
要想弄懂这套接口，关键的是要明白接口的继承关系： interface java.lang.Cloneable
-
- interface org.dom4j.Node
-
-
- interface org.dom4j.Attribute
- interface org.dom4j.Branch
-
-
-
-
- interface org.dom4j.Document
- interface org.dom4j.Element
- interface org.dom4j.CharacterData
- interface org.dom4j.CDATA
- interface org.dom4j.Comment
- interface org.dom4j.Text
- interface org.dom4j.DocumentType
- interface org.dom4j.Entity
- interface org.dom4j.ProcessingInstruction
-
-
下面给出一些例子，简单说一下如何使用。
１． 读取并解析 XML 文档：
读写 XML 文档主要依赖于 org.dom4j.io 包，其中提供 DOMReader 和 SAXReader 两类不同方式，而调用方式是一样的。这就是依靠接口的好处。
// 从文件读取 XML ，输入文件名，返回 XML 文档
public Document read(StringfileName) throws MalformedURLException,DocumentException{
SAXReader reader=new SAXReader();
Document document=reader.read(new File(fileName));
return document;
}
其中， reader 的 read 方法是重载的，可以从 InputStream, File, Url 等多种不同的源来读取。得到的 Document 对象就带表了整个 XML 。
读取的字符编码是按照 XML 文件头定义的编码来转换。如果遇到乱码问题，注意要把各处的编码名称保持一致即可。
２． 取得 Root 节点
读取后的第二步，就是得到 Root 节点。熟悉 XML 的人都知道，一切 XML 分析都是从 Root 元素开始的。
public Element getRootElement(Document doc){
return doc.getRootElement();
}
３． 遍历 XML 树
DOM4J 提供至少 3 种遍历节点的方法：
1) 枚举 (Iterator)
// 枚举所有子节点
for ( Iterator i = root.elementIterator(); i.hasNext(); ) {
Element element=(Element)i.next();
// do something
}
// 枚举名称为 foo 的节点
for ( Iterator i = root.elementIterator( foo ); i.hasNext();) {
Element foo=(Element)i.next();
// do something
}
// 枚举属性
for ( Iterator i = root.attributeIterator(); i.hasNext(); ) {
Attribute attribute=(Attribute)i.next();
// do something
}
2) 递归
递归也可以采用 Iterator 作为枚举手段，但文档中提供了另外的做法
public void treeWalk(){
treeWalk(getRootElement());
}
public void treeWalk(Element element){
for(inti=0,size=element.nodeCount();i<size;i++) {
Node node=element.node(i);
if(node instanceof Element){
treeWalk((Element)node);
}else{// do something....
}
}
}
3) Visitor 模式
最令人兴奋的是 DOM4J 对 Visitor 的支持，这样可以大大缩减代码量，并且清楚易懂。了解设计模式的人都知道， Visitor 是 GOF 设计模式之一。其主要原理就是两种类互相保有对方的引用，并且一种作为 Visitor 去访问许多 Visitable 。我们来看 DOM4J 中的 Visitor 模式 ( 快速文档中没有提供 )
只需要自定一个类实现 Visitor 接口即可。
public class MyVisitor extends VisitorSupport{
publicvoidvisit(Elementelement){
System.out.println(element.getName());
}
public void visit(Attribute attr){
System.out.println(attr.getName());
}
}
调用：
root.accept(new MyVisitor())
Visitor 接口提供多种 Visit() 的重载，根据 XML 不同的对象，将采用不同的方式来访问。上面是给出的 Element 和 Attribute 的简单实现，一般比较常用的就是这两个。 VisitorSupport 是 DOM4J 提供的默认适配器， Visitor 接口的 Default Adapter 模式，这个模式给出了各种 visit(*) 的空实现，以便简化代码。
注意，这个 Visitor 是自动遍历所有子节点的。如果是 root.accept(MyVisitor) ，将遍历子节点。
4. XPath 支持
DOM4J 对 XPath 有良好的支持，如访问一个节点，可直接用 XPath 选择。
|
public void bar(Document document){ List list=document.selectNodes(//foo/bar); Node node=document.selectSingleNode(//foo/bar/author); String name=node.valueOf(@name); }
|
例如，如果你想查找 XHTML 文档中所有的超链接，下面的代码可以实现：
|
public void findLinks(Documentdocument)throws DocumentException{ List list=document.selectNodes(//a/@href); for(Iterator iter=list.iterator();iter.hasNext();){ Attribute attribute=(Attribute)iter.next(); String url=attribute.getValue(); } }
|
5. 字符串与 XML 的转换
有时候经常要用到字符串转换为 XML 或反之，
Document document = ...; String text =document.asXML(); // 字符串转 XML String text= "<person><name>James</name></person>"; Document document=DocumentHelper.parseText(text);
|
6 用 XSLT 转换 XML
|
public Document styleDocument(Documentdocument, Stringstylesheet )throws Exception{ // load the transformer using JAXP TransformerFactory factory=TransformerFactory.newInstance(); Transformer transformer=factory.newTransformer( new StreamSource(stylesheet) ); // now lets style the given document DocumentSource source=new DocumentSource(document); DocumentResult result=new DocumentResult(); transformer.transform(source,result); // return the transformed document Document transformedDoc=result.getDocument(); return transformedDoc; }
|
7. 创建 XML
一般创建 XML 是写文件前的工作，这就像 StringBuffer 一样容易。
|
public Document createDocument(){
Document document=DocumentHelper.createDocument(); Element root=document.addElement(root); Element author1= root.addElement(author) .addAttribute(name,James) .addAttribute(location,UK) .addText(James Strachan); Element author2= root.addElement(author) .addAttribute(name,Bob) .addAttribute(location,US) .addText(Bob McWhirter); return document; }
|
8. 创建 XML(2)
一般创建 XML 是写文件前的工作，这就像 StringBuffer 一样容易。
| public class RequestXMLBuilder { public String SecurityToken = ""; public String GetRequestXML() {
|
一个简单的输出方法是将一个 Document 或任何的 Node 通过 write 方法输出
FileWriter out = new FileWriter( foo.xml ); document.write(out);
|
public void write(Document document)throws IOException{ // 指定文件 XMLWriterwriter=newXMLWriter(new FileWriter(output.xml) ); writer.write(document); writer.close(); // 美化格式 OutputFormat format=OutputFormat.createPrettyPrint(); writer=new XMLWriter(System.out,format); writer.write(document); // 缩减格式 format=OutputFormat.createCompactFormat(); writer=new XMLWriter(System.out,format); writer.write(document); }
|
DOM4J 官方网站： http://www.dom4j.org
DOM4J 下载 (SourceForge) http://sourceforge.net/projects/dom4j
参考资料：
DOM4J 文档
Java 中的 XML ： 文档模型，第一部分：性能
http://www-900.ibm.com/developerWorks/cn/xml/x-injava/index.shtml
Java 中的 XML ： Java 文档模型的用法
http://www-900.ibm.com/developerWorks/cn/xml/x-injava2/index.shtml
Java XML API 漫谈 by robbin
http://www.hibernate.org.cn:8000/137.html