`

DOM4J 使用简介

阅读更多

转:http://blog.csdn.net/icecloud/article/details/7795

 

DOM4J dom4j.org 出品的一个开源 XML 解析包,它的网站中这样定义:

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

DOM4J 使用起来非常简单。只要你了解基本的 XML-DOM 模型,就能使用。然而他自己带的指南只有短短一页( html ),不过说的到挺全。国内的中文资料很少。因而俺写这个短小的教程方便大家使用,这篇文章仅谈及基本的用法,如需深入的使用,请 …… 自己摸索或查找别的资料。

之前看过 IBM developer 社区的文章(参见附录),提到一些 XML 解析包的性能比较,其中 DOM4J 的性能非常出色,在多项测试中名列前茅。(事实上 DOM4J 的官方文档中也引用了这个比较)所以这次的项目中我采用了 DOM4J 作为 XML 解析工具。

在国内比较流行的是使用 JDOM 作为解析器,两者各擅其长,但 DOM4J 最大的特色是使用大量的接口,这也是它被认为比 JDOM 灵活的主要原因。大师不是说过么, 面向接口编程 。目前使用 DOM4J 的已经越来越多。如果你善于使用 JDOM ,不妨继续用下去,只看看本篇文章作为了解与比较,如果你正要采用一种解析器,不如就用 DOM4J 吧。

它的主要接口都在 org.dom4j 这个包里定义:

Attribute

Attribute 定义了 XML 的属性

Branch

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

CDATA

CDATA 定义了 XML CDATA 区域

CharacterData

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

Comment

Comment 定义了 XML 注释的行为

Document

定义了 XML 文档

DocumentType

DocumentType 定义 XML DOCTYPE 声明

Element

Element 定义 XML 元素

ElementHandler

ElementHandler 定义了 Element 对象的处理器

ElementPath

ElementHandler 使用,用于取得当前正在处理的路径层次信息

Entity

Entity 定义 XML entity

Node

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

NodeFilter

NodeFilter 定义了在 dom4j 节点中产生的一个滤镜或谓词的行为( predicate

ProcessingInstruction

ProcessingInstruction 定义 XML 处理指令 .

Text

Text 定义 XML 文本节点 .

Visitor

Visitor 用于实现 Visitor 模式 .

XPath

XPath 在分析一个字符串后会提供一个 XPath 表达式

看名字大致就知道它们的涵义如何了。

要想弄懂这套接口,关键的是要明白接口的继承关系:

一目了然,很多事情都清楚了。大部分都是由 Node 继承来的。知道这些关系,将来写程序就不会出现 ClassCastException 了。

下面给出一些例子(部分摘自 DOM4J 自带的文档),简单说一下如何使用。

1.              读取并解析 XML 文档:

读写 XML 文档主要依赖于 org.dom4j.io 包,其中提供 DOMReader SAXReader 两类不同方式,而调用方式是一样的。这就是依靠接口的好处。

 

    // 从文件读取 XML ,输入文件名,返回 XML 文档

    public Document read(String fileName) throws MalformedURLException, DocumentException {

       SAXReader reader = new SAXReader();

       Document document = reader.read( new File(fileName));

       return document;

    }

 

其中, reader read 方法是重载的,可以从 InputStream, File, Url 等多种不同的源来读取。得到的 Document 对象就带表了整个 XML

根据本人自己的经验,读取的字符编码是按照 XML 文件头定义的编码来转换。如果遇到乱码问题,注意要把各处的编码名称保持一致即可。

2.    取得 Root 节点

读取后的第二步,就是得到 Root 节点。熟悉 XML 的人都知道,一切 XML 分析都是从 Root 元素开始的。

 

    public Element getRootElement(Document doc){

       return doc.getRootElement();

    }

 

3.    遍历 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 ( int i = 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 {

           public void visit(Element element){

               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) ,将遍历子节点。我第一次用的时候,认为是需要自己遍历,便在递归中调用 Visitor ,结果可想而知。

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(Document document) 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 或反之,

 
    
// 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(

       Document document,

       String stylesheet

    ) 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. 文件输出

    一个简单的输出方法是将一个 Document 或任何的 Node 通过 write 方法输出

 

    FileWriter out = new FileWriter( foo.xml );

    document.write(out);

 

  
如果你想改变输出的格式,比如美化输出或缩减格式,可以用
XMLWriter

 

    public void write(Document document) throws IOException {

       // 指定文件

       XMLWriter writer = new XMLWriter(

           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 够简单吧,当然,还有一些复杂的应用没有提到,如 ElementHandler 等。如果你动心了,那就一起来用 DOM4J.

DOM4J 官方网站: ( 我老连不上 )

http://www.dom4j.org

DOM4J 下载 (SourceForge) ,最新版本为 1.4

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

分享到:
评论

相关推荐

    dom4j使用简介

    **DOM4J使用简介** DOM4J 是一个强大的 Java 库,专为处理 XML 文档而设计。它提供了丰富的 API,使得在 Java 中解析、创建、修改 XML 文件变得简单高效。DOM4J 不仅支持 DOM(文档对象模型)和 SAX(简单API for ...

    Dom4j使用简介

    Dom4j使用简介,日志 开发java必看,初级高级开发必看

    Dom4j 使用简介

    ### Dom4j 使用简介 #### 一、Dom4j 概述 Dom4j 是一个易用且功能强大的开源 XML 解析库,适用于 Java 平台。它支持 DOM、SAX 和 JAXP 标准,并且采用了 Java 集合框架进行数据管理。Dom4j 在设计时考虑到了开发者...

    Dom4j解析XML(例子)+Dom4j 使用简介

    **Dom4j解析XML(例子)+Dom4j 使用简介** Dom4j是一个强大的Java库,专门用于处理XML文档。它提供了灵活且易于使用的API,使得XML的读取、写入、遍历和修改变得简单。在本文中,我们将深入探讨Dom4j的主要功能和用法...

    《Dom4j使用简介》.pdf

    ### Dom4j 使用简介 #### 一、Dom4j 概述 Dom4j 是一个简单易用的开源库,用于处理 XML、XPath 和 XSLT,在 Java 平台上使用 Java 集合框架,并全面支持 DOM、SAX 和 JAXP。它提供了一种非常高效的方式来读取、...

    DOM4J使用简介(很实用)

    ### DOM4J 使用简介 DOM4J是一款专为简化XML处理流程而设计的开源Java库。根据其官方网站的介绍,DOM4J不仅易于使用,而且提供了丰富的功能来处理XML、XPath以及XSLT等技术。它完全兼容DOM、SAX和JAXP标准,并且在...

    Dom4J 1.6.1jar包+API+使用简介

    `Dom4j使用简介.pdf`提供了Dom4J的基本使用教程,涵盖了如何创建、解析、修改XML文档,以及如何使用XPath等内容。新手可以通过阅读这份指南快速上手。 总之,Dom4J 1.6.1是处理XML文档的得力工具,无论是在小型项目...

    DOM4J jar包 xml解析 所有的dom4j-1.6.1 dom4j-2.0.2 dom4j-2.1.1包 导入直接使用

    在项目中使用DOM4J时,只需将相应的jar包(如dom4j-1.6.1.jar、dom4j-2.0.2.jar或dom4j-2.1.1.jar)导入到类路径中,即可开始利用其功能处理XML文档。导入后,可以按照DOM4J提供的API进行编程,快速实现XML的读写...

    DOM4J 的使用

    一、DOM4J 简介 DOM4J 是一个基于 Java 的 XML 解析包,用于解析和操作 XML 文档。它提供了一个简洁的 API,方便用户快速地解析和操作 XML 文档。DOM4J 采用了 Java 集合框架,完全支持 DOM、SAX 和 JAXP。 二、...

    Dom4j解析XML+使用简介

    **Dom4j解析XML+使用简介** Dom4j是一个非常流行的Java库,专门用于处理XML文档,它提供了灵活且高效的方式来解析、创建和操作XML内容。这个库在XML处理领域中备受推崇,因为它简单易用,同时又具有高度的灵活性和...

    Dom4j 使用简介.pdf

    ### DOM4j 使用详解 #### 引言 DOM4j是一款功能强大且易于使用的开源XML解析库,专门针对Java平台设计。它不仅支持DOM、SAX和JAXP标准,还充分利用了Java集合框架,使得处理XML数据变得更加高效和直观。DOM4j由dom...

    dom4j_dom4j1.6.1安装包_

    总之,DOM4J 1.6.1是一个功能强大且广泛使用的XML处理库,它的Maven集成使得在Java项目中使用变得方便。无论是创建XML文档、查询XML结构还是进行XML数据操作,DOM4J都能提供简洁、高效的API。在安装和使用过程中,...

Global site tag (gtag.js) - Google Analytics