JDOM 是一種使用 XML 的獨特 Java 工具包，用于快速開(kāi)發(fā) XML 應用程序。它的設計包含 Java 語(yǔ)言的語(yǔ)法乃至語(yǔ)義。但是它是否比現有的 -- 更標準的 -- XML API 好呢？當我們看過(guò)一些示例并說(shuō)明這個(gè)流行的開(kāi)放源代碼項目的設計目標后，您自己來(lái)判斷吧。最近這個(gè)開(kāi)放源代碼項目已被正式接受成為 Java 規范要求。
作為開(kāi)發(fā)人員，您可能聽(tīng)說(shuō)過(guò) 80-20 規則，在其它領(lǐng)域被稱(chēng)為 Pareto 法則：一種過(guò)程或方法能適應所有可能情況的 80%，另外的 20% 則需要根據具體情況來(lái)處理。軟件開(kāi)發(fā)的必然結果是：對于開(kāi)發(fā)人員而言，有了給定的技術(shù)后就能非常容易地完成可能要做的工作的 80%。
當然，軟件產(chǎn)品和標準并不總是根據 80-20 規則發(fā)展的。特別的，Java XML 的缺陷就是這條規則的一個(gè)例外。Java 的編程世界擁有很多的 API -- 一些是自己開(kāi)發(fā)的，一些是由幾個(gè)大公司開(kāi)發(fā)并被制定為標準的 -- 他們提供了解決特殊 XML 任務(wù)的成熟解決方案。作為 XML 普遍性的證明，每個(gè)新任務(wù)都存在著(zhù)一種新技術(shù)，但如何將它們結合在一起，又如何尋找一種合適的工具去完成必須重復做的任務(wù)中的 80% -- 利用 Java 語(yǔ)言的直觀(guān)映象的基本 XML 樹(shù)操作？JDOM 正好是用來(lái)解決上述問(wèn)題的一個(gè) XML API。
標記：Java 和 XML
在許多方面，Java 語(yǔ)言已變成供 XML 選擇的一種編程語(yǔ)言。由于 Apache 軟件基金會(huì )和 IBM alphaWorks 所做的開(kāi)創(chuàng )性工作，現在已有完整的工具鏈用于創(chuàng )建，操作，傳送文檔和對 XML 文檔進(jìn)行語(yǔ)法分析。
但是，雖然許多 Java 開(kāi)發(fā)人員每天都在使用 XML，Sun 卻在將 XML 整合進(jìn) Java 平臺方面落后了。因為在 XML 成為從商家對商家集成到 Web 站點(diǎn)內容流水化等方面的關(guān)鍵技術(shù)之前，Java 2 平臺就已經(jīng)非常流行了。Sun 已經(jīng)使用 JSR 過(guò)程使之成為現存 XML API 的鼻祖，這一點(diǎn)已被廣泛接受。目前最顯著(zhù)的是加入了 JAXP （用于 XML 語(yǔ)法分析的 Java API），其中包含了三個(gè)軟件包：
org.w3c.dom，W3C 推薦的用于 XML 標準規劃文檔對象模型的 Java 工具
org.xml.sax，用于對 XML 進(jìn)行語(yǔ)法分析的事件驅動(dòng)的簡(jiǎn)單 API
javax.xml.parsers，工廠(chǎng)化工具，允許應用程序開(kāi)發(fā)人員獲得并配置特殊的語(yǔ)法分析器工具
盡管對于 Java 開(kāi)發(fā)人員而言，有了這些軟件包是件好事，但它僅僅代表獲得了現有 API 標準的正式許可而已，并沒(méi)有在提供一流的 Java-XML 互操作性方面取得了巨大飛躍。核心 Java 平臺所缺乏的是將 XML 文檔作為 Java 對象操作的直觀(guān)接口。
進(jìn)入 JDOM。JDOM 是兩位著(zhù)名的 Java 開(kāi)發(fā)人員兼作者，Brett Mclaughlin 和 Jason Hunter 的創(chuàng )作成果， 2000 年初在類(lèi)似于 Apache 協(xié)議的許可下，JDOM 作為一個(gè)開(kāi)放源代碼項目正式開(kāi)始研發(fā)，JDOM 作為一個(gè)開(kāi)放源代碼項目正式開(kāi)始了。它已成長(cháng)為包含來(lái)自廣泛的 Java 開(kāi)發(fā)人員的投稿、集中反饋及錯誤修復的系統，并致力于建立一個(gè)完整的基于 Java 平臺的解決方案，通過(guò) Java 代碼來(lái)訪(fǎng)問(wèn)、操作并輸出 XML 數據。
這是 JDOM 適合的 API、啞元
JDOM 能夠替換 org.w3c.dom 軟件包來(lái)有計劃地操作 XML 文檔。它并不是一個(gè)簡(jiǎn)單的替代品，實(shí)際上 JDOM 和 DOM 能夠愉快地并存。另外，盡管它提供的類(lèi)的封裝從配置和運行分析器執行中分擔了大量工作，但它不負責根據文本輸入來(lái)對 XML 進(jìn)行語(yǔ)法分析。JDOM 建立在現有的 API 的能力之上，正如項目網(wǎng)頁(yè)所表述的“一個(gè)更好的捕鼠器”。
要理解需要備用 API 的原因，就要考慮 W3C DOM 設計的局限性：
語(yǔ)言獨立。DOM 并不是用人們心目中的 Java 語(yǔ)言設計的。雖然這種方法保留了在不同語(yǔ)言中非常相似的 API，它也使那些習慣 Java 語(yǔ)言的程序員感到更麻煩。例如：Java 語(yǔ)言?xún)冉艘环N String 類(lèi)，而 DOM 則規范定義了自己的 Text 類(lèi)。
嚴格的層次結構。DOM API 直接沿襲了 XML 規范。在 XML 中，每件東西都是一個(gè)結點(diǎn)，因此您能在 DOM 中找到一個(gè)幾乎每件東西都可以擴展的基于 Node 的接口和返回 Node 的一系列方法。就多態(tài)性的觀(guān)點(diǎn)來(lái)講，它是優(yōu)秀的，但鑒于如上解釋?zhuān)?Java 語(yǔ)言中的應用是困難而且不便的，其中從 Node 向葉類(lèi)型作顯式下拉會(huì )導致代碼的冗長(cháng)和難以理解。
接口驅動(dòng)。公共 DOM API 僅由接口組成（Exception 類(lèi)是一個(gè)例外，但恰恰足夠了）。w3c 對提供實(shí)現并不感興趣，它只對定義接口（比較有意義）感興趣。但它也意味著(zhù)作為 Java 程序員使用 API 在創(chuàng )建 XML 對象時(shí)增加了分散程度，因為 w3c 標準大量使用工廠(chǎng)化的類(lèi)和類(lèi)似的靈活的但不直接的模式。在某些應用中，XML 文檔是僅由語(yǔ)法分析器建立的，而從不會(huì )由應用程序級代碼建立，這是不相關(guān)的。但是，隨著(zhù) XML 更廣泛的使用，并不是所有問(wèn)題都繼續需要由語(yǔ)法分析器來(lái)驅動(dòng)。應用程序的開(kāi)發(fā)人員需要一個(gè)更方便的方法有計劃地構造 XML 對象。
對于程序員，這些約束意味著(zhù)龐大（在內存占用和接口大小方面）的和難掌握的 API，學(xué)習和使用都很難。相反，JDOM 是作為一種輕量級 API 被制定的，最主要的是它是以 Java 為中心的。它在遵循 DOM 主要規則的基礎上除去了上述缺點(diǎn)：
JDOM 是 Java 平臺專(zhuān)用的。只要有可能，API 都使用 Java 語(yǔ)言的內建 String 支持，因此文本值也適用于 String。它還可利用 Java 2 平臺的類(lèi)集，如 List 和 Iterator，給程序員提供了一個(gè)豐富的并且和 Java 語(yǔ)言類(lèi)似的環(huán)境。
沒(méi)有層次性。在 JDOM 中，XML 元素就是 Element 的實(shí)例，XML 屬性就是 Attribute 的實(shí)例，XML 文檔本身就是 Document 的實(shí)例。由于在 XML 中所有這些都代表了不同的概念，因此它們總是作為自己的類(lèi)型被引用，而不是作為一個(gè)含糊的“結點(diǎn)”。
類(lèi)驅動(dòng)。因為 JDOM 對象就是像 Document、Element 和 Attribute 這些類(lèi)的直接實(shí)例，因此創(chuàng )建一個(gè)新 JDOM 對象就如在 Java 語(yǔ)言中使用 new 操作符一樣容易。它還意味著(zhù)不需要進(jìn)行工廠(chǎng)化接口配置 -- JDOM 的使用是直截了當的。
看，沒(méi)有 Node：建立和操作 JDOM 文檔
JDOM 使用標準的 Java 編碼模式。只要有可能，它使用 Java new 操作符而不用復雜的工廠(chǎng)化模式，使對象操作即便對于初學(xué)用戶(hù)也很方便。例如，讓我們看一下如何隨便使用 JDOM 建立一個(gè)簡(jiǎn)單的 XML 文檔。我們將要建立的結構如清單 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 中有詳細描述。
開(kāi)始，讓我們先創(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ù)必導入 org.jdom.*。）因為一個(gè) XML 文檔必須一直有一個(gè)唯一的根元素，所以 Document 將 Element 放在它的構造器中。
下一步，添加 vin 屬性：
清單 3. 添加一個(gè) Attribute
carElement.addAttribute(new Attribute("vin", "123fhg5869705iop90"));
添加元素也是很簡(jiǎn)單的。這里我們添加 make 元素：
清單 4. 元素和子元素
Element make = new Element("make");
make.addContent("Toyota");
carElement.addContent(make);
由于 Element 的 addContent 方法返回 Element，我們也可以這樣寫(xiě)：
清單 5. 用簡(jiǎn)潔形式添加元素
carElement.addContent(new Element("make").addContent("Toyota"));
這兩個(gè)語(yǔ)句完成了相同的工作。有些人認為第一個(gè)示例可讀性更好，但是如果您一次建立許多元素，您會(huì )覺(jué)得第二個(gè)示例可讀性更好。要完成構建文檔：
清單 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ì )注意到對于 license 元素，我們不但添加了元素的內容，還為其添加了一個(gè)屬性，表明許可已被發(fā)出了這個(gè)狀態(tài)。這是因為 Element 的 addContent 方法總是返回 Element 本身，而不是一個(gè)無(wú)效的聲明。
用同樣的方法添加注釋部分或其它標準 XML 類(lèi)型：
清單 7. 添加一條注釋
carElement.addContent(new Comment("Description of a car"));
操作文檔也是用類(lèi)似方式。例如，要引用 year 元素，我們使用 Element 的 getChild 方法：
清單 8. 訪(fǎng)問(wèn)子元素
Element yearElement = carElement.getChild("year");
該語(yǔ)句實(shí)際上將返回第一個(gè)元素名為 year 的子 Element。 如果沒(méi)有 year 元素，則調用返回一個(gè)空值。注意，我們不必回溯來(lái)自任何類(lèi)似于 DOM Node 接口的返回值 -- Element 的子元素就是 Element。用類(lèi)似的方式，我們可把 year 元素從文檔中除去：
清單 9. 除去子元素
boolean removed = carElement.removeChild("year");
這次調用將只除去 year 元素；文檔的其余部分保持不變。
到目前為止，我們已經(jīng)涵蓋了文檔的生成和操作。要將完成的文檔輸出至控制臺，可使用 JDOM 的 XMLOutputter 類(lèi)：
清單 10. 將 JDOM 轉化為 XML 文本
try {
XMLOutputter outputter = new XMLOutputter(" ", true);
outputter.output(myDocument, System.out);
} catch (java.io.IOException e) {
e.printStackTrace();
}
XMLOutputter 有幾個(gè)格式選項。這里我們已指定希望子元素從父元素縮進(jìn)兩個(gè)空格，并且希望元素間有空行。 XMLOutputter 可輸出到 Writer 或 OutputStream。為輸出到文件，我們可以簡(jiǎn)單地將輸出行簡(jiǎn)化為：
清單 11. 使用 FileWriter 輸出 XML
FileWriter writer = new FileWriter("/some/directory/myFile.xml");
outputter.output(myDocument, writer);
writer.close();
與其它方法良好協(xié)作：和現有的 XML 工具進(jìn)行互操作
JDOM 的一個(gè)有趣特征是和其它 API 有互操作性。使用 JDOM，不僅能把文檔輸出到 Stream 或 Reader，還可將文檔作為 SAX Event Stream 或作為 DOM Document。這種靈活性允許 JDOM 能在多種環(huán)境下使用或被添加到已經(jīng)在使用另一種方法處理 XML 的系統中去。正如我們在后面一個(gè)示例中所看到的，它還允許 JDOM 使用其它的還不能識別 JDOM 的數據結構的 XML 工具。
JDOM 的另一個(gè)用處是它能夠讀取并操作現有的 XML 數據。使用 org.jdom.input 中的一個(gè)類(lèi)可以閱讀結構很規范的 XML 文件。在這個(gè)示例中我們使用 SAXBuilder：
清單 12. 使用 SAXBuilder 對 XML 文件進(jìn)行語(yǔ)法分析
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 中顯示的方法來(lái)操作通過(guò)這個(gè)過(guò)程建立的文檔。
JDOM 的另一個(gè)實(shí)用應用程序將其與 Apache 的 Xalan 產(chǎn)品結合在一起（請參閱參考資料）。使用上面的汽車(chē)示例，我們將為在線(xiàn)汽車(chē)經(jīng)銷(xiāo)商建立一個(gè) Web 頁(yè)面，顯示特定汽車(chē)的詳細信息。首先，假設我們上面建立的文檔顯示我們準備呈現給用戶(hù)的汽車(chē)的信息。下一步，我們將把這個(gè) JDOM Document 與一個(gè) XSL 樣式表結合起來(lái)并把 HTML 格式的結果輸出到 servlet 的 OutputStream 上以便在用戶(hù)的瀏覽器中顯示。
在本例中，我們準備使用的 XSL 樣式表被稱(chēng)為 car.xsl：
清單 13. 用于將汽車(chē)記錄轉換為 HTML 的 XSL 文檔
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="
<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>
現在我們將把 org.jdom.Document 轉換為 DOM Document，并將其與顯示我們的 XSL 和 OutputStream 的文件一起提供給 Xalan，OutputStream 是我們從我們假定的使用 servlet（如清單 14 所示）的應用服務(wù)器上獲取的。
清單 14. 使用 JDOM 和 Xalan 創(chuàng )建 HTML 文檔 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è)示例中，輸出是通過(guò) Java servlet 的 HTTPResponse OutputStream 流出。然而，輸出流可以象早期的使用 XMLOutputter 的實(shí)例一樣簡(jiǎn)單的通過(guò)文件流輸出。我們使用 DOMOutputter 為 Xalan 生成 XML 源代碼。但是我們可以生成相同的輸出，方法是使用 XMLOutputter 將我們的 XML 文檔作為 String 輸出并使其進(jìn)入 StreamSource。說(shuō)到靈活性：JDOM 可將它的結構作為 String、SAX Event Stream 或 DOM Document 輸出。這允許 JDOM 與能把任何這些模型作為輸入的工具一起工作。（關(guān)于附加功能，請訪(fǎng)問(wèn) JDOM Web 站點(diǎn)的 contrib 包，在那里您將發(fā)現一個(gè)基于 JDOM 工具的寶庫，可提供基于 JDBC ResultSet 的構建器、XPATH 實(shí)現方法和其它更多工具。）
在短短幾行代碼中，JDOM 啟用了許多功能，我們已經(jīng)在 XML 中分析過(guò)并有計劃地創(chuàng )建了 XML 文檔，操作了那些文檔，并使用它們產(chǎn)生 XML 驅動(dòng)的 Web 頁(yè)面。
Sun 和 JDOM：名字里包含了些什么？
JDOM 的 1.0 正式發(fā)行版可能與其在 Java Community Process 中的一貫發(fā)展方向相符。作為 JSR-102 提交的 JDOM 已經(jīng)批準成為了核心 Java 平臺的最終包含部分。Sun 對此的評價(jià)是：“JDOM 確實(shí)明顯地比早期的 API 更易于使用，因此我們相信它將成為 Java 平臺有用的附加物。”據 JSR 透露，JDOM 1.0 發(fā)行版的包裝可能由 "org.jdom" 變?yōu)?"javax.xml"。盡管前景樂(lè )觀(guān)，但開(kāi)發(fā)人員可能最終不得不改變他們的代碼來(lái)使用新代碼。
JDOM 的成長(cháng)：前景一瞥
正如此文所提的那樣，JDOM 項目已經(jīng)發(fā)布了它的 Beta 6 版本。甚至在 beta 狀態(tài)下，對于許多真實(shí)世界中的實(shí)現方法來(lái)說(shuō)，JDOM 已經(jīng)被證明是穩定的一種了。盡管大部分的 API 已經(jīng)穩固了，但在一些領(lǐng)域中仍在進(jìn)行一些會(huì )對現有的接口造成潛在影響的工作。因此，在這點(diǎn)上，任何在進(jìn)行的開(kāi)發(fā)項目都不需要因為害怕一個(gè)錯誤多多的實(shí)現方法而回避 JDOM，但是要考慮這樣一個(gè)事實(shí)：某些方法結構或某些語(yǔ)義仍有可能在最終發(fā)布和被核心 Java API 所采用之前發(fā)生改變。（請參閱名字里包含了些什么？）
JDOM 緊接著(zhù)要做的是致力于穩定 API 并對實(shí)現方法的各方面性能問(wèn)題作出評估。其它方面有所進(jìn)展，但也造成了對一些應用程序開(kāi)發(fā)人員的阻礙，包括支持 DTD 實(shí)體和其它不太常見(jiàn)的構造。沿著(zhù)這條路再進(jìn)一步就是對 XPATH（它是一種象 XSLT 這樣的應用程序所特有的 XML 路徑語(yǔ)言）的核心支持以及更多地集成 XML 數據源。
那么，概況地說(shuō)，JDOM 是否比現有的 XML API 好呢？如果您夢(mèng)想 Java，那答案可能是“是的”。JDOM 并非意味著(zhù)將取代您所喜愛(ài)的語(yǔ)法分析或 XML 敏感型數據庫，但其設計原則有助于為試圖掌握 XML 世界的新老 Java 開(kāi)發(fā)人員提供快速的學(xué)習途徑。
參考資料
請下載樣本代碼（一個(gè) Java 類(lèi)的源代碼版本和經(jīng)編譯的版本，包括本文使用的所有示例代碼以及 XML 和 XSL 文件）。您會(huì )需要在類(lèi)路徑中的 JDOM、Xerces 和 Xalan 來(lái)運行代碼。
如想獲得 JDOM 的最新版本、在線(xiàn) API 文檔及更多信息，請訪(fǎng)問(wèn) JDOM 網(wǎng)站。
如想獲得有關(guān) Xalan、Xerces 和其它 Java XML 產(chǎn)品的更多信息，請訪(fǎng)問(wèn) Apache XML 網(wǎng)站。
請訪(fǎng)問(wèn) XML 網(wǎng)站，獲取一般 XML 信息、教程和資源。
請不要忘記 developerWorks XML 專(zhuān)區，那兒有大量和 XML 有關(guān)的內容。
IBM 的 alphaWorks 網(wǎng)站為 Java 和 XML 開(kāi)發(fā)人員提供了幾個(gè)工具：
XML Parser for Java 包含了對 DOM 級別 1 和 SAX 級別 1 規范的公開(kāi)的和穩定的支持。
為了診斷對 XML Schema 語(yǔ)言的不正確使用，請嘗試 XML Schema Quality Checker。
XML Security Suite 提供了多種安全性功能，例如數字簽名、元素式的加密和訪(fǎng)問(wèn)控制。
利用 XSL Editor 來(lái)測試和編輯您的 XSL。
IBM XML parser for Java (XML4J) 是一個(gè)控制 XML 文檔的便利工具。 “使用 IBM XML 分析器”會(huì )教您它的用法。（IBM PartnerWorld for Developers，2000 年 1 月）
JDOM 的創(chuàng )建者都是知名作家。我們推薦您閱讀 Jason Hunter 的 “ Java Servlet Programming，第 2 版” （O‘Reilly，2001 年 4 月）和 Brett McLaughlin 的 " Java and XML" （O‘Reilly，2000 年 6 月）。
除此之外， 以下是 Brett 為 developerWorks 撰寫(xiě)的幾篇相關(guān)文章：
“從 DOM 轉換”（2001 年 4 月）
“從 SAX 轉換”（2001 年 4 月）
“使用 JDOM 和 XSLT”（2001 年 3 月）
“有關(guān) JAXP 的一切”（2000 年 11 月）
“ JAXP 重溫” （2000 年 12 月）
