教您快速上手使用JDOM处理XML文档的技巧

JDOM的介绍以及与JAXB的比较

Java + XML = JDOM ！

这就是JDOM设计者的目标。如果你曾经使用过烦人的SAX或是DOM来处理XML，你就会知道为什么要有JDOM或者是JAXB。在JavaOne会议上JDOM的主要创始人Jason Hunter有一篇精彩的演讲介绍了JDOM技术，题目就是JDOM Makes XML Easy。

在那篇文档里，JDOM被拿来与DOM比较，而我更愿意拿它同JAXB比较。因为JAXB和JDOM都是为了在Java中提供比DOM和SAX更为方便的XML处理接口而开发的，并且通过完全不同的途径来解决这个问题。JDOM的处理方式是与DOM类似的树操作。而JAXB通过DTD和绑定模式来生成访问XML文档的Java代码，将XML映射成了Java对象来操作。你可以根据项目的需要和个人喜好来决定采用哪一个。

JDOM与JAXB的比较，从本身的特点来看：

1) JDOM比JAXB更容易上手。使用JAXB首先要会编写DTD，然后还要会编写绑定模式。JDOM没有这样的要求，如果你会Java和XML，甚至可以说光是看JDOM的javadoc文档就能够使用JDOM。

2) JAXB编写好DTD和绑定模式以后，XML文档被映射成了Java对象，其数据就是Java对象的属性，连数据类型都做好了转换，因此，访问XML文档比JDOM要简便，可以说是一劳永逸。

3) JAXB由某个DTD和绑定模式生成的代码只能访问该DTD所约束的文档。如果想要访问其他XML文档，需要再编写DTD和绑定模式。JDOM可以处理任何XML文档，包括受约束的和不受约束的。

目前JDOM和JAXB都没有正式版本。JDOM的最新版本是beta8，JAXB是1.0 early access，其规范版本是0.21。相对而言，JDOM更成熟一些。例如JAXB不支持名字空间、不能向XML文档写入处理指令，有时我们需要保留的换行符和首尾空格在JAXB中自动过滤掉了，就连放在里面也不能幸免。JDOM就没有这些限制。如果说以上的3点比较是JDOM和JAXB本身的特点所决定的，几乎不可能改变，那么这里表明，JAXB还需要更多的工作。

获得并安装JDOM

在http://jdom.org可以下载JDOM的最新版本。以JDOM beta8的2进制版本为例。下载后解压缩，JDOM的jar文件就是build目录下的文件jdom.jar，将之加入类路径。另外JDOM还需要lib目录下那些jar文件如xerces.jar的支持。如果在使用中出现以下错误：

java.lang.NoSuchMethodError

或

java.lang.NoClassDefFoundError: 
org/xml/sax/SAXNotRecognizedException

你需要保证xerces.jar文件在CLASSPATH中位于其他XML类，如JAXP或Crimson之前，这些类文件，包括以前老版本的xerces，可能不支持SAX2.0或DOM Level 2。于是导致了上面的错误。

一个简单的例子

JDOM的处理方式有些类似于DOM，但它主要是用SAX实现的，你不必担心处理速度和内存的问题。另外，JDOM中几乎没有接口，的类全部是实实在在的类，没有类工厂类的。其最重要的一个包org.jdom中主要有以下类：

– Attribute
– CDATA
– Comment
– DocType
– Document
– Element
– EntityRef
– Namespace
– ProcessingInstruction
– Text

数据输入要用到XML文档要通过org.jdom.input包，反过来需要org.jdom.output。如前面所说，关是看API文档就能够使用。

我们的例子读入XML文件exampleA.xml，加入一条处理指令，修改第一本书的价格和作者，并添加一条属性，然后写入文件exampleB.xml：

//exampleA.xml

<?xml version="1.0"
encoding="GBK"?>
<bookList>
<book>
 <name>Java编程入门</name>
 <author>张三</author>
 <publishDate>2002-6-6</publishDate>
<price>35.0</price>
</book>
 <book>
<name>XML在Java中的应用</name>
<author>李四</author>
<publishDate>2002-9-16</publishDate>
<price>92.0</price>
</book>
</bookList>
//testJDOM.java
import org.jdom.*;
import org.jdom.output.*;
import org.jdom.input.*;
import java.io.*;
public class TestJDOM
{
public static void main
(String args[])throws Exception
{
SAXBuilder sb = new SAXBuilder();
//从文件构造一个Document，
因为XML文件中已经指定了编码，所以这里不必了
 Document doc = sb.build(new
 FileInputStream("exampleA.xml"));
//加入一条处理指令
ProcessingInstruction pi = 
new ProcessingInstruction
("xml-stylesheet",
"href=\"bookList.html.xsl\" type=\"text/xsl\"");
 doc.addContent(pi);
Element root = doc.getRootElement();
//得到根元素
java.util.List books = root.getChildren();
//得到根元素所有子元素的集合
Element book = (Element)books.get(0); 
//得到第一个book元素
//为第一本书添加一条属性
 Attribute a = new Attribute("hot","true");  
book.setAttribute(a);
 Element author = book.getChild("author");
 //得到指定的字元素
author.setText("王五"); 
//将作者改为王五
//或 Text t = new Text("王五");
book.addContent(t);
Element price = book.getChild("price");
//得到指定的字元素
//修改价格，比较郁闷的是我们必须自己
转换数据类型，而这正是JAXB的优势
author.setText(Float.toString(50.0f)); 
 String indent = "    ";
 boolean newLines = true;
 XMLOutputter outp =
 new XMLOutputter(indent,newLines,"GBK");
 outp.output(doc,
 new FileOutputStream("exampleB.xml"));
}
};

执行结果exampleB.xml：

<?xml version="1.0" encoding="GBK"?>

<bookList>

    <book hot=true>

        <name>Java编程入门</name>

        <author>50.0</author>

        <publishDate>2002-6-6</publishDate>

        <price>35.0</price>

    </book>

    <book>

        <name>XML在Java中的应用</name>

        <author>李四</author>

        <publishDate>2002-9-16</publishDate>

        <price>92.0</price>

    </book>

</bookList>

<?xml-stylesheet href="bookList.html.xsl" 
type="text/xsl"?>

在默认情况下，JDOM的Element类的getText()这类的方法不会过滤空白字符，如果你需要过滤，用setTextTrim() 。

爱心技术专栏专题

首页

教您快速上手使用JDOM处理XML文档的技巧

教您快速上手使用JDOM处理XML文档的技巧