XML 是一種優秀的資料打包與交換形式。在當今 XML 大行其道的時代,要是還沒聽過它的大名,那可真是孤陋寡聞了。用 XML 描述資料的優勢不言自明:它結構簡單,兼具「人和機器都易讀」的雙重好處,還彌補了關聯式資料庫對現實世界數據描述能力的不足。W3C 依技術領域的需要制定了 XML 的格式規範,並相應建立了描述模型,簡稱 DOM。各種主流程式語言都依據這套模型推出了自己的 XML 解析器;在 Java 世界裡,Apache 組織開發的 Xerces 應該是流傳最廣、功能最強大的 XML 解析器之一。
然而,由於 W3C 在設計 DOM 模型時並非針對某一種語言,為了通用性而加入了許多繁瑣又非必要的細節,使得 Java 開發者在撰寫 XML 應用程式時頗感不便。於是 JDOM 作為一種新型 XML 解析器應運而生——它並不遵循 DOM 模型,而是建立了自己獨立的一套 JDOM 模型(請注意,JDOM 絕不是 DOM 的擴充,兩者名稱雖像,卻是平行關係),並提供功能強大、使用方便的類別庫,讓 Java 開發者能更有效率地開發 XML 應用程式,大幅減少程式碼量。因此它很快獲得了業界認可,連 JBuilder 這類重量級產品都採用 JDOM 作為 XML 解析引擎,足見其名不虛傳。
有了 XML 的資料描述標準,人們自然會想:是不是該有一種查詢語言,能在 XML 中查找任意節點的資料,就像 SQL 能在關聯式資料庫中執行查詢那樣?於是 XQuery 與 XPath 順應潮流而生。由於 XQuery 較為複雜、使用不很方便,XPath 逐漸成為主流——我們只要把 XPath 學好,大致就能應付所有查詢需求。而在 JDOM 最新的 V1.0 beta10 版中,已經加入了对 XPath 的支援,這無疑令開發者十分振奮。
學會 JDOM 與 XPath,你便不再是 XML 的門外漢。在未來的開發生涯中,它們就像特種兵的多用途匕首,為你披荊斬棘、助你勇往直前。閒言少敘,學習還得腳踏實地、從頭開始。
XPath 遵循文件物件模型(DOM)的路徑格式。由於每個 XML 文件都可看作一棵擁有許多結點的樹,而每個結點可以是以下七種類型之一:根(root)、元素(element)、屬性(attribute)、正文(text)、命名空間(namespace)、處理指令(processing instruction)與註解(comment)。XPath 的基本語法由運算式構成,計算運算式的值之後會產生一個物件,這種物件有四種基本類型:節點集合、布林型、數字型與字串型。
XPath 基本上和你在檔案系統中尋找檔案類似:若路徑以「/」開頭,就表示這是一個絕對路徑,這與 UNIX 系統中對檔案路徑的定義一致;以「//」開頭則表示要在文件中的任意位置查找。
空談理論無益,學 XPath 還是要從實例入手最為快捷,也有助於你舉一反三。
下面的範例 XML 文件描述了某台電腦中硬碟的資訊(根節點 HD 代表硬碟,disk 標籤代表硬碟分割區,從它的 name 屬性可以看出有兩個分割區,代號分別為「C」與「D」;每個分割區下都包含 capacity、directories、files 三個節點,分別代表分割區的空間大小、目錄數量與所含檔案個數):
<?XML version="1.0" encoding="UTF-8"?> <HD> <disk name="C"> <capacity>8G</capacity> <directories>200</directories> <files>1580</files> </disk> <disk name="D"> <capacity>10G</capacity> <directories>500</directories> <files>3000</files> </disk> </HD>
你在 XML 文件中用位置路徑運算式來查找資訊,而這些運算式有許多種組成方式。
結點元素的查找,是你最常碰到的查找方式。在上面這個 XML 例子中,根 HD 包含 disk 結點。你可以用路徑來查找這些結點,以正斜線(/)分隔子結點,回傳所有與模式相符的元素。下面的 XPath 語句會回傳所有的 disk 元素:
/HD/disk
「*」代表「全部」的意思,/HD/* 代表 HD 底下的全部節點。
下面的 XPath 會回傳任意節點下、名為 disk 的全部節點:
//disk
下面的 XPath 會回傳名為 disk、且 name 屬性為 'C' 的全部節點:
/HD/disk[@name='C']
節點的附加元素(例如屬性、函式等)都要用方括號括起來,屬性前面還要加上 @ 號。
下面的 XPath 會回傳檔案個數為 1580 的 files 節點:
/HD/disk/files[text()='1580']
請注意,這裡用到了一个 text(),它是 XPath 的一個函式,功能是取出當前節點的文字。
下面的 XPath 會回傳檔案個數為 1580 的分割區:
/HD/disk/files[text()='1580']/parent::*
最後的 parent::* 表示這個元素所有父節點的集合。
XPath 中一些實用的函式:
string concat(string, string, string*) 串接兩個字串 boolean starts-with(string, string) 判斷某字串是否以另一字串開頭 boolean contains(string, string) 判斷某字串是否包含另一字串 string substring(string, number, number) 取子字串 number string-length(string) 量字串長度 number sum(node-set) 求和 number floor(number) 求小於此數的最大整數 number ceiling(number) 求大於此數的最小整數
XPath 的表達功能十分豐富,上面這些大致已經夠用。實際做專案時你會發現有各種依情境而定的查詢需求,這時就該翻閱本文末尾提供的、W3C 發布的 XPath 官方資料。我在這裡只起拋磚引玉的作用,後面的應用範例也不會超出上面提到的範圍。若你對 XPath 有興趣,讀完本文後應再找相關資料與書籍深入研究。
用過 Xerces 的開發者都會有這種感覺:有些話一句就能說清楚,換成用 Xerces 的 API 來實作,卻要寫上三四行程式。
你可以在 https://www.jdom.org/ 下載 JDOM 的最新版本,把壓縮檔中的 jdom.jar 及 lib 目錄下的全部 jar 檔加入 classpath 就可以了。
JDOM 模型的全部類別都在 org.jdom.* 這個套件裡,其中 org.jdom.input.* 套件包含了 JDOM 的解析器:DOMBuilder 負責把 DOM 模型的 Document 解析成 JDOM 模型的 Document;SAXBuilder 則負責從檔案或串流中解析出符合 JDOM 模型的 XML 樹。由於前面提到的 XML 範例存在一個名為 sample.xml 的檔案中,顯然我們應該採用後者作為解析工具。下面的程式展示了 JDOM 的基本功能——解析一個 XML 文件,並挑選部分內容輸出到螢幕上。
import Java.util.*;
import org.jdom.*;
import org.jdom.input.SAXBuilder;
public class Sample1 {
public static void main(String[] args) throws Exception{
SAXBuilder sb=new SAXBuilder();
Document doc=sb.build("sample.XML");
Element root=doc.getRootElement();
List list=root.getChildren("disk");
for(int i=0;i<list.size();i++){
Element element=(Element)list.get(i);
String name=element.getAttributeValue("name");
String capacity=element.getChildText("capacity");
String directories=element.getChildText("directories");
String files=element.getChildText("files");
System.out.println("磁盤信息:");
System.out.println("分區盤符:"+name);
System.out.println("分區容量:"+capacity);
System.out.println("目錄數:"+directories);
System.out.println("文件數:"+files);
System.out.println("-----------------------------------");
}
}
}
程式的輸出結果:
磁盤信息: 分區盤符:C 分區容量:8G 目錄數:200 文件數:1580 ----------------------------------- 磁盤信息: 分區盤符:D 分區容量:10G 目錄數:500 文件數:3000 -----------------------------------
這段程式採用了傳統的解析方式,一層一層地從根節點到子節點逐一采集所需的資料,中規中矩。但試想,如果這棵樹夠深,而我們想取第 50 層第三個節點的資料(雖然有點誇張,呵呵),那將是一場噩夢!接下來的內容,就能輕鬆化解你的這份痛苦。
說了那麼多 JDOM 與 XPath 的好處,終於到了英雄有用武之地的時候。
JDOM 關於 XPath 的 API 都在 org.jdom.xpath 這個套件裡。看看這個套件底下,只有一個類別——JDOM 就是這麼簡潔,從不把簡單的事搞得複雜。這個類別的核心 API 主要有兩個:selectNodes() 與 selectSingleNode()。前者依一個 XPath 語句回傳一組節點;後者則依一個 XPath 語句回傳符合條件的第一個節點。
下面的程式用 JDOM + XPath 實現了上一個程式同樣的功能,從中你可以學到不少運用 XPath 的知識:
import Java.util.*;
import org.jdom.*;
import org.jdom.input.SAXBuilder;
import org.jdom.xpath.XPath;
public class Sample2 {
public static void main(String[] args) throws Exception {
SAXBuilder sb = new SAXBuilder();
Document doc = sb.build("sample.XML");
Element root = doc.getRootElement();
List list = XPath.selectNodes(root, "/HD/disk");
for (int i = 0; i < list.size(); i++) {
Element disk_element = (Element) list.get(i);
String name = disk_element.getAttributeValue("name");
String capacity = ( (Text) XPath.selectSingleNode(disk_element,
"//disk[@name='" + name + "']/capacity/text()")).getTextNormalize();
String directories = ( (Text) XPath.selectSingleNode(disk_element,
"//disk[@name='" + name + "']/directories/text()")).getTextNormalize();
String files = ( (Text) XPath.selectSingleNode(disk_element,
"//disk[@name='" + name + "']/files/text()")).getTextNormalize();
System.out.println("磁盤信息:");
System.out.println("分區盤符:" + name);
System.out.println("分區容量:" + capacity);
System.out.println("目錄數:" + directories);
System.out.println("文件數:" + files);
System.out.println("-----------------------------------");
}
}
}
輸出結果:
磁盤信息: 分區盤符:C 分區容量:8G 目錄數:200 文件數:1580 ----------------------------------- 磁盤信息: 分區盤符:D 分區容量:10G 目錄數:500 文件數:3000 -----------------------------------
技術日新月異,世上永遠沒有學一次後便能一勞永逸的技術,XML 的發展更是突飛猛進。W3C 作為網際網路領域的權威組織,引領著網路技術的發展方向;新技術的出現大多圍繞著 W3C 制訂的標準,但也往往有些「旁門左道」的另類功法,反而能產生驚人的殺傷力,JDOM 便是這眾多旁門中的一朵奇葩。
就像在 J2EE 大行其道的今天,仍有許多開源組織默默打造著自己的獨家兵器,誰又能斷言在不久的將來,它們不會成為劃時代的創造呢?君不見 Hibernate 的興起,正有力地撼動著 J2EE 中 EJB 架構的基石。只要是成型的框架,必然存在薄弱的環節;新技術只要能攻入對方的這個弱點,便能在業界站穩一席之地。本文同樣只起拋磚引玉的作用,相信讀者在嚐過這道快餐之後,一定會發現窗外還有更美麗的風景,等著我們去游历。