溫馨蟲窩

看，沒有 Node：建立和操作 JDOM 文檔
JDOM 使用標(biāo)準(zhǔn)的 Java 編碼模式。只要有可能，它使用 Java new 操作符而不用復(fù)雜的工廠化模式，使對(duì)象操作即便對(duì)于初學(xué)用戶也很方便。例如，讓我們看一下如何隨便使用 JDOM 建立一個(gè)簡單的 XML 文檔。我們將要建立的結(jié)構(gòu)如清單 1 所示。（從參考資料上可下載關(guān)于本文的完整代碼）

清單 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 中有詳細(xì)描述。

開始，讓我們先創(chuàng)建一個(gè)根元素，并將其添加到文檔中：

清單 2. 創(chuàng)建一個(gè) Document

Element carElement = new Element("car");
Document myDocument = new Document(carElement);

這一步創(chuàng)建一個(gè)新 org.jdom.Element，并將其作為 org.jdom.Document myDocument 的根元素。（如果您使用參考資料中提供的樣本代碼，請務(wù)必導(dǎo)入 org.jdom.*。）因?yàn)橐粋€(gè) XML 文檔必須一直有一個(gè)唯一的根元素，所以 Document 將 Element 放在它的構(gòu)造器中。

下一步，添加 vin 屬性：

清單 3. 添加一個(gè) 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"));

這兩個(gè)語句完成了相同的工作。有些人認(rèn)為第一個(gè)示例可讀性更好，但是如果您一次建立許多元素，您會(huì)覺得第二個(gè)示例可讀性更好。要完成構(gòu)建文檔：

清單 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"));

您會(huì)注意到對(duì)于 license 元素，我們不但添加了元素的內(nèi)容，還為其添加了一個(gè)屬性，表明許可已被發(fā)出了這個(gè)狀態(tài)。這是因?yàn)?Element 的 addContent 方法總是返回 Element 本身，而不是一個(gè)無效的聲明。

用同樣的方法添加注釋部分或其它標(biāo)準(zhǔn) XML 類型：

清單 7. 添加一條注釋

carElement.addContent(new Comment("Description of a car"));

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

清單 8. 訪問子元素

Element yearElement = carElement.getChild("year");

該語句實(shí)際上將返回第一個(gè)元素名為 year 的子 Element。 如果沒有 year 元素，則調(diào)用返回一個(gè)空值。注意，我們不必回溯來自任何類似于 DOM Node 接口的返回值 -- Element 的子元素就是 Element。用類似的方式，我們可把 year 元素從文檔中除去：

清單 9. 除去子元素

boolean removed = carElement.removeChild("year");

這次調(diào)用將只除去 year 元素；文檔的其余部分保持不變。

到目前為止，我們已經(jīng)涵蓋了文檔的生成和操作。要將完成的文檔輸出至控制臺(tái)，可使用 JDOM 的 XMLOutputter 類：

清單 10. 將 JDOM 轉(zhuǎn)化為 XML 文本

try {
    XMLOutputter outputter = new XMLOutputter("  ", true);
    outputter.output(myDocument, System.out);
} catch (java.io.IOException e) {
    e.printStackTrace();
}

XMLOutputter 有幾個(gè)格式選項(xiàng)。這里我們已指定希望子元素從父元素縮進(jìn)兩個(gè)空格，并且希望元素間有空行。 XMLOutputter 可輸出到 Writer 或 OutputStream。為輸出到文件，我們可以簡單地將輸出行簡化為：

清單 11. 使用 FileWriter 輸出 XML

FileWriter writer = new FileWriter("/some/directory/myFile.xml");
outputter.output(myDocument, writer);
writer.close();

與其它方法良好協(xié)作：和現(xiàn)有的 XML 工具進(jìn)行互操作
JDOM 的一個(gè)有趣特征是和其它 API 有互操作性。使用 JDOM，不僅能把文檔輸出到 Stream 或 Reader，還可將文檔作為 SAX Event Stream 或作為 DOM Document。這種靈活性允許 JDOM 能在多種環(huán)境下使用或被添加到已經(jīng)在使用另一種方法處理 XML 的系統(tǒng)中去。正如我們在后面一個(gè)示例中所看到的，它還允許 JDOM 使用其它的還不能識(shí)別 JDOM 的數(shù)據(jù)結(jié)構(gòu)的 XML 工具。

JDOM 的另一個(gè)用處是它能夠讀取并操作現(xiàn)有的 XML 數(shù)據(jù)。使用 org.jdom.input 中的一個(gè)類可以閱讀結(jié)構(gòu)很規(guī)范的 XML 文件。在這個(gè)示例中我們使用 SAXBuilder：

清單 12. 使用 SAXBuilder 對(duì) XML 文件進(jìn)行語法分析

try {
  SAXBuilder builder = new SAXBuilder();
  Document anotherDocument = 
    builder.build(new File("/some/directory/sample.xml"));
} catch(JDOMException e) {
  e.printStackTrace();
} catch(NullPointerException e) {
  e.printStackTrace();
}

您可以用清單 2 到清單 7 中顯示的方法來操作通過這個(gè)過程建立的文檔。

JDOM 的另一個(gè)實(shí)用應(yīng)用程序?qū)⑵渑c Apache 的 Xalan 產(chǎn)品結(jié)合在一起（請參閱參考資料）。使用上面的汽車示例，我們將為在線汽車經(jīng)銷商建立一個(gè) Web 頁面，顯示特定汽車的詳細(xì)信息。首先，假設(shè)我們上面建立的文檔顯示我們準(zhǔn)備呈現(xiàn)給用戶的汽車的信息。下一步，我們將把這個(gè) JDOM Document 與一個(gè) XSL 樣式表結(jié)合起來并把 HTML 格式的結(jié)果輸出到 servlet 的 OutputStream 上以便在用戶的瀏覽器中顯示。

在本例中，我們準(zhǔn)備使用的 XSL 樣式表被稱為 car.xsl：

清單 13. 用于將汽車記錄轉(zhuǎn)換為 HTML 的 XSL 文檔

<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:template match="/car">
    <html>
        <head>
          <title><xsl:value-of select="make"/> <xsl:value-of select="model"/>
        </head>
        <body>
          <h1><xsl:value-of select="make"/></h1><br />
          <h2><xsl:value-of select="model"/></h2><br />
          <table border="0">
          <tr><td>VIN:</td><td><xsl:value-of select="@vin"/></td></tr>
          <tr><td>Year:</td><td><xsl:value-of select="year"/></td></tr>
          <tr><td>Color:</td><td><xsl:value-of select="color"/></td></tr>
          </table>
        </body>
    </html>
  </xsl:template>
</xsl:stylesheet>

現(xiàn)在我們將把 org.jdom.Document 轉(zhuǎn)換為 DOM Document，并將其與顯示我們的 XSL 和 OutputStream 的文件一起提供給 Xalan，OutputStream 是我們從我們假定的使用 servlet（如清單 14 所示）的應(yīng)用服務(wù)器上獲取的。

TransformerFactory tFactory = TransformerFactory.newInstance();

// Make the input sources for the XML and XSLT documents
org.jdom.output.DOMOutputter outputter = new org.jdom.output.DOMOutputter();
org.w3c.dom.Document domDocument = outputter.output(myDocument);
javax.xml.transform.Source xmlSource = 
  new javax.xml.transform.dom.DOMSource(domDocument);
StreamSource xsltSource = 
  new StreamSource(new FileInputStream("/some/directory/car.xsl"));

// Make the output result for the finished document using 
// the HTTPResponse OutputStream
StreamResult xmlResult = new StreamResult(response.getOutputStream());

// Get a XSLT transformer
Transformer transformer = tFactory.newTransformer(xsltSource);

// Do the transform
transformer.transform(xmlSource, xmlResult);

在這個(gè)示例中，輸出是通過 Java servlet 的 HTTPResponse OutputStream 流出。然而，輸出流可以象早期的使用 XMLOutputter 的實(shí)例一樣簡單的通過文件流輸出。我們使用 DOMOutputter 為 Xalan 生成 XML 源代碼。但是我們可以生成相同的輸出，方法是使用 XMLOutputter 將我們的 XML 文檔作為 String 輸出并使其進(jìn)入 StreamSource。說到靈活性：JDOM 可將它的結(jié)構(gòu)作為 String、SAX Event Stream 或 DOM Document 輸出。這允許 JDOM 與能把任何這些模型作為輸入的工具一起工作。（關(guān)于附加功能，請?jiān)L問 JDOM Web 站點(diǎn)的 contrib 包，在那里您將發(fā)現(xiàn)一個(gè)基于 JDOM 工具的寶庫，可提供基于 JDBC ResultSet 的構(gòu)建器、XPATH 實(shí)現(xiàn)方法和其它更多工具。）

在短短幾行代碼中，JDOM 啟用了許多功能，我們已經(jīng)在 XML 中分析過并有計(jì)劃地創(chuàng)建了 XML 文檔，操作了那些文檔，并使用它們產(chǎn)生 XML 驅(qū)動(dòng)的 Web 頁面。

JDOM 的成長：前景一瞥
正如此文所提的那樣，JDOM 項(xiàng)目已經(jīng)發(fā)布了它的 Beta 6 版本。甚至在 beta 狀態(tài)下，對(duì)于許多真實(shí)世界中的實(shí)現(xiàn)方法來說，JDOM 已經(jīng)被證明是穩(wěn)定的一種了。盡管大部分的 API 已經(jīng)穩(wěn)固了，但在一些領(lǐng)域中仍在進(jìn)行一些會(huì)對(duì)現(xiàn)有的接口造成潛在影響的工作。因此，在這點(diǎn)上，任何在進(jìn)行的開發(fā)項(xiàng)目都不需要因?yàn)楹ε乱粋€(gè)錯(cuò)誤多多的實(shí)現(xiàn)方法而回避 JDOM，但是要考慮這樣一個(gè)事實(shí)：某些方法結(jié)構(gòu)或某些語義仍有可能在最終發(fā)布和被核心 Java API 所采用之前發(fā)生改變。（請參閱名字里包含了些什么？）

JDOM 緊接著要做的是致力于穩(wěn)定 API 并對(duì)實(shí)現(xiàn)方法的各方面性能問題作出評(píng)估。其它方面有所進(jìn)展，但也造成了對(duì)一些應(yīng)用程序開發(fā)人員的阻礙，包括支持 DTD 實(shí)體和其它不太常見的構(gòu)造。沿著這條路再進(jìn)一步就是對(duì) XPATH（它是一種象 XSLT 這樣的應(yīng)用程序所特有的 XML 路徑語言）的核心支持以及更多地集成 XML 數(shù)據(jù)源。

那么，概況地說，JDOM 是否比現(xiàn)有的 XML API 好呢？如果您夢想 Java，那答案可能是“是的”。JDOM 并非意味著將取代您所喜愛的語法分析或 XML 敏感型數(shù)據(jù)庫，但其設(shè)計(jì)原則有助于為試圖掌握 XML 世界的新老 Java 開發(fā)人員提供快速的學(xué)習(xí)途徑。