要操作XML,第一步是把它變成程式裡的物件。這篇筆記從NamedNodeMap談起,一路走到用DOM載入文檔並遍歷節點。
實作了NamedNodeMap接口的物件,裡頭裝的是一組可以「靠名字」存取的節點集合。有個細節常被誤解:NamedNodeMap並不是從NodeList繼承而來,而且它包含的節點是無序的。
雖然這些節點也可以用索引存取,但那只是提供一種枚舉的便利手段,並不代表DOM規範替它們規定了排列順序。NamedNodeMap表達的是「節點」與「唯一名字」之間的一一對應關係,主要用在屬性節點的表示上。與NodeList相同,NamedNodeMap物件在DOM中也是"live"的——文檔變了,它也跟著變。
有了DOM,開發人員可以動態建立文檔、遍歷文檔結構,以及新增、修改、刪除文檔內容。以下用微軟的XML分析器msXML來說明這些操作。
JScript:
var doc = new ActiveXObject("Microsoft.XMLDOM")
VBScript:
Dim doc
Set doc = CreateObject("Microsoft.XMLDOM")
Visual Basic 有兩種寫法:
Dim doc As Object
Set doc = CreateObject("Microsoft.XMLDOM")
' 或者直接使用早期綁定
Dim doc As DOMDocument
Set doc = New DOMDocument
Visual C++:
HRESULT hr = CoCreateInstance(
CLSID_DOMDocument, NULL, CLSCTX_INPROC_SERVER,
IID_IXMLDocument, (LPVOID*)&m_pXMLDocument);
早期綁定(VB的第二種寫法)的好處是IntelliSense能提示方法與屬性,編譯期就能抓到打錯字;代價是必須在專案裡正確引用型別程式庫。
不同XML分析器提供的載入方法名稱不盡相同。微軟的msxml提供 load 方法,用來載入XML文檔並建立DOM樹與文檔之間的關聯。以聯絡人列表的XML檔為例:
Dim myDocument
Set myDocument = CreateObject("microsoft.XMLdom")
myDocument.async = False
myDocument.load("client.XML")
把async設為False是為了同步載入,確保後續程式碼執行時文檔已經完整就緒;若保持預設的非同步,讀取內容時可能還什麼都拿不到。
root = myDocument.documentElement
這一行取得文檔的根元素節點,也就是整棵DOM樹的入口。
以文檔中的第二個person元素為例,要讀出它的姓名,可以逐層往下走:
personNode = root.childNodes.item(1)
nameNode = personNode.childNodes.item(0)
textNode = nameNode.childNodes.item(0)
theName = textNode.nodeValue
執行完之後,theName的值就是「李四」。
這裡有個關鍵細節:item的索引是從0開始的。所以要取根元素addressbook下的第二個person子節點,參數得寫 item(1);若要取第一個,則是 item(0)。這個差一錯誤(off-by-one)是初學者最常犯的毛病。
另外,在上面的程式碼中,root是根元素節點addressbook,personNode與nameNode都是元素型別的節點,textNode是TEXT型別的節點,而theName只是一個字串。childNodes是NodeList型別的屬性,item則是NodeList接口中用來取節點的方法。
依DOM規範,要取得元素節點的文字內容,必須先取得它的TEXT子節點,再透過該子節點的屬性讀取。微軟在實作時做了部分擴充,允許直接用元素節點的 text 屬性拿到文字,省下好幾行。這屬於廠商擴充而非標準行為,跨平台時要留意,細節可參考MSDN的說明。
屬性節點的存取方式與元素節點略有不同,得透過NamedNodeMap:
attr = node.attributes.getNamedItem("sex")
attrContent = attr.nodeValue
執行後attrContent的值是"male"。這裡attr是屬性型別的節點,attributes是NamedNodeMap型別的屬性,getNamedItem則是NamedNodeMap接口中的方法;屬性的實際內容,同樣透過nodeValue取得。
把元素與屬性兩條路徑記牢,DOM的讀取部分基本就通了。剩下寫入的部分,則是下一階段的addChild、removeChild與modify主題。