對於 XML 檔案中沒有帶命名空間(NameSpace)的節點,例如:
<blog_Content>
用 JDOM 的 XPath 搜尋時,可以用下面任一種寫法:
① List<Element> elements = XPath.selectNodes(document, "//blog_Content");
② XPath xpath = XPath.newInstance("//blog_Content");
List<Element> elements = xpath.selectNodes(document);
但如果要查詢的是帶命名空間的節點,例如:
<blogns:blog_Content xmlns:blogns="x-schema:#Schema2">
<blogns:Title>Quartz Job Scheduling Framework[翻譯]第一章. 企業應用中的作業調度</blogns:Title>
..............................................
這時若沿用前面兩種寫法就會查不到 blog_Content 節點。即使改成:
List<Element> elements = XPath.selectNodes(document, "//blogns:blog_Content");
或者針對 <blogns:Title> 寫成:
List<Element> elements = XPath.selectNodes(document, "//blogns:Title");
結果都一樣,elements.size() 會是 0,什麼都撈不到。
關鍵在於:我們必須明確告訴 XPath 實例它要使用的命名空間。做法是呼叫 XPath 的 addNamespace() 方法:
XPath xpath = XPath.newInstance("//blogns:blog_Content");
xpath.addNamespace("blogns", "x-schema:#Schema2");
List<Element> elements = xpath.selectNodes(document);
如此一來就能檢索到 <blogns:blog_Content> 節點,<blogns:Title> 也是同樣的做法。
如果節點用的是預設命名空間,例如要查詢下面這段 XML 的 <blog_Content>:
<blog_Content xmlns="x-schema:#Schema2">
<Title>Quartz Job Scheduling Framework[翻譯]第一章. 企業應用中的作業調度</Title>
.................................
按照一般直覺,預設命名空間大概就是空字串,那麼是不是這樣寫就能找到節點?
XPath xpath = XPath.newInstance("//blog_Content");
xpath.addNamespace("", "x-schema:#Schema2");
List<Element> elements = xpath.selectNodes(document);
很遺憾,這裡的 elements.size() 依然等於 0,檢索失敗。
JDOM 要求(這究竟是 JDOM 獨有的規範,還是所有 XML 解析 API 的通則,我並不確定):即使使用的是預設命名空間,用 XPath 檢索時也必須為這個預設命名空間指定一個名稱。我們這裡選用 "default",其實你可以任取一個不衝突的名字,別被 "default" 這個字誤導以為非它不可。所以查詢 <blog_Content> 的正確寫法是:
XPath xpath = XPath.newInstance("//default:blog_Content");
xpath.addNamespace("default", "x-schema:#Schema2");
List<Element> elements = xpath.selectNodes(document);
這樣就能順利檢索到你要的節點了。
補充一下,本文的 XML 範例節選自 BlogJava 部落格的日誌備份資料檔(在 BlogJava 管理後台點「備份資料」所存下的 MyBlogData.XML)。
順帶分享一個消息:我已經把《Quartz Job Scheduling Framework 中文教程.chm》製作完成,很快就會公開分享。製作流程是這樣的——從日誌備份檔 MyBlogData.XML 中,用 JDOM XPath 讀出所有 Quartz Job Scheduling Framework 的翻譯日誌、排序,再用範本逐一產生 HTML 檔,最後放進 Visual CHM 的專案裡編譯即可。只要部落格上的日誌內容有變動,馬上就能生成新版的 CHM。
下面附上一段程式,用來列出備份檔 MyBlogData.XML 中所有本站發佈日誌的標題:
package com.unmi;
import java.util.List;
import org.jdom.Document;
import org.jdom.Element;
import org.jdom.input.SAXBuilder;
import org.jdom.xpath.XPath;
/**
* JDOM 使用 XPath 查找帶 NameSpace 的節點
* @author Unmi
*/
public class XPathWithNS {
public static void main(String[] args) throws Exception {
SAXBuilder builder = new SAXBuilder(false);
Document document = builder.build("D:/Unmi/MyBlogData.XML");
// 找出在本站原創的日誌,PostType='1' 應該就是這個意義
XPath xpath = XPath.newInstance("//default:blog_Content[default:PostType='1']");
// 列出所有 Quartz Job Scheduling Framework 翻譯文檔的 XPath
// XPath xpath = XPath.newInstance("//default:blog_Content[contains(default:Title,'Quartz Job Scheduling Framework') and PostType='1']");
xpath.addNamespace("default", "x-schema:#Schema2");
List<Element> elements = xpath.selectNodes(document);
for (int i = 0; i < elements.size(); i++) {
Element element = (Element) elements.get(i);
XPath xpathTitle = XPath.newInstance("default:Title");
xpathTitle.addNamespace("default", "x-schema:#Schema2");
String title = ((Element) xpathTitle.selectSingleNode(element)).getTextTrim();
System.out.println((i + 1) + ". " + title);
}
}
}
程式裡用到的 XPath 實作類其實是 org.jdom.xpath.JaxenXPath,所以專案需要參考的套件有:jdom.jar、saxpath.jar、jaxen-core.jar、jaxen-jdom.jar。另外也可以改用 XPath 的另一個實作類 org.jaxen.jdom.JDOMXPath。