建立和操作 JDOM 文档

JDOM 使用标准的 Java 编码模式。只要有可能，它使用 Java new 操作符而不用复杂的工厂化模式，使对象操作即便对于初学用户也很方便。例如，让我们看一下如何随便使用 JDOM 建立一个简单的 XML 文档。我们将要建立的结构如清单 1 所示。（从 参考资料上可下载关于本文的完整代码）


清单 1. 建立 XML 文档样本
<?xml version="1.0" encoding="UTF-8"?>
<car vin="123fhg5869705iop90">
  <!--Description of a car-->
  <make>Toyota</make>
  <model>Celica</model>
  <year>1997</year>
  <color>green</color>
  <license state="CA">1ABC234</license>
</car>



注意：我们将建立 示例文档，在下面的清单 2 到清单 7 中有详细描述。

开始，让我们先创建一个根元素，并将其添加到文档中：


清单 2. 创建一个 Document
Element carElement = new Element("car");
Document myDocument = new Document(carElement);



这一步创建一个新 org.jdom.Element ，并将其作为 org.jdom.Document myDocument 的根元素。（如果您使用 参考资料中提供的样本代码，请务必导入 org.jdom.* 。）因为一个 XML 文档必须一直有一个唯一的根元素，所以 Document 将 Element 放在它的构造器中。

下一步，添加 vin 属性：


清单 3. 添加一个 Attribute
carElement.addAttribute(new Attribute("vin", "123fhg5869705iop90"));



添加元素也是很简单的。这里我们添加 make 元素：


清单 4. 元素和子元素
Element make = new Element("make");
make.addContent("Toyota");
carElement.addContent(make);



由于 Element 的 addContent 方法返回 Element ，我们也可以这样写：


清单 5. 用简洁形式添加元素
carElement.addContent(new Element("make").addContent("Toyota"));



这两个语句完成了相同的工作。有些人认为第一个示例可读性更好，但是如果您一次建立许多元素，您会觉得第二个示例可读性更好。要完成构建文档：


清单 6. 添加其余的元素
carElement.addContent(new Element("model").addContent("Celica"));
carElement.addContent(new Element("year").addContent("1997"));
carElement.addContent(new Element("color").addContent("green"));
carElement.addContent(new Element("license")
    .addContent("1ABC234").addAttribute("state", "CA"));



您会注意到对于 license 元素，我们不但添加了元素的内容，还为其添加了一个属性，表明许可已被发出了这个状态。这是因为 Element 的 addContent 方法总是返回 Element 本身，而不是一个无效的声明。

用同样的方法添加注释部分或其它标准 XML 类型：


清单 7. 添加一条注释
carElement.addContent(new Comment("Description of a car"));



操作文档也是用类似方式。例如，要引用 year 元素，我们使用 Element 的 getChild 方法：


清单 8. 访问子元素
Element yearElement = carElement.getChild("year");



该语句实际上将返回第一个元素名为 year 的子 Element 。 如果没有 year 元素，则调用返回一个空值。注意，我们不必回溯来自任何类似于 DOM Node 接口的返回值 -- Element 的子元素就是 Element 。用类似的方式，我们可把 year 元素从文档中除去：


清单 9. 除去子元素
boolean removed = carElement.removeChild("year");



这次调用将只除去 year 元素；文档的其余部分保持不变。

到目前为止，我们已经涵盖了文档的生成和操作。要将完成的文档输出至控制台，可使用 JDOM 的 XMLOutputter 类：


清单 10. 将 JDOM 转化为 XML 文本
try {
    XMLOutputter outputter = new XMLOutputter("  ", true);
    outputter.output(myDocument, System.out);
} catch (java.io.IOException e) {
    e.printStackTrace();
}



XMLOutputter 有几个格式选项。这里我们已指定希望子元素从父元素缩进两个空格，并且希望元素间有空行。 XMLOutputter 可输出到 Writer 或 OutputStream 。为输出到文件，我们可以简单地将输出行简化为：


清单 11. 使用 FileWriter 输出 XML
FileWriter writer = new FileWriter("/some/directory/myFile.xml");
outputter.output(myDocument, writer);
writer.close();