DOM 定義了一組標準命令集,讓你能在程式中存取 HTML 與 XML 文件的內容。支援 DOM 的 XML 解析器會把 XML 文件中的資料取出,並透過一組可程式化的物件把它暴露出來。本文帶你走一遍:當 XML 文件被 Microsoft XML Parser(Msxml.dll)解析後,如何以 XML DOM 存取與操作它。
在看程式碼前,先感受一下解析器如何讓事情變簡單。以下是一份收錄 CD 資訊的 Cds.xml,每筆資料含藝術家、標題與曲目等資訊:
<?xml version="1.0"?>
<!DOCTYPE compactdiscs SYSTEM "cds.dtd">
<compactdiscs>
<compactdisc>
<artist type="individual">Frank Sinatra</artist>
<title numberoftracks="4">In The Wee Small Hours</title>
<tracks>
<track>In The Wee Small Hours</track>
<track>Mood Indigo</track>
<track>Glad To Be Unhappy</track>
<track>I Get Along Without You Very Well</track>
</tracks>
<price>$12.99</price>
</compactdisc>
<compactdisc>
<artist type="band">The Offspring</artist>
<title numberoftracks="5">Americana</title>
<tracks>
<track>Welcome</track>
<track>Have You Ever</track>
<track>Staring At The Sun</track>
<track>Pretty Fly (For A White Guy)</track>
</tracks>
<price>$12.99</price>
</compactdisc>
</compactdiscs>
第二行參照了外部的 DTD(文件類型定義)。DTD 定義了某類 XML 文件的版面與預期內容,解析器可據此判斷文件是否有效。除了 DTD,另一種愈來愈受歡迎的驗證方式是「XML 架構」,差別在於架構本身用 XML 定義,而 DTD 使用自己的一套語法。以下是 Cds.dtd 的內容:
<!ELEMENT compactdiscs (compactdisc*)>
<!ELEMENT compactdisc (artist, title, tracks, price)>
<!ENTITY % Type "individual | band">
<!ELEMENT artist (#PCDATA)>
<!ATTLIST artist type (%Type;) #REQUIRED>
<!ELEMENT title (#PCDATA)>
<!ATTLIST title numberoftracks CDATA #REQUIRED>
<!ELEMENT tracks (track*)>
<!ELEMENT price (#PCDATA)>
<!ELEMENT track (#PCDATA)>
XML 的 DOM 是一個暴露出文件內容的物件模型。W3C 的 DOM Level 1 規格定義了 DOM 應暴露出哪些屬性、方法與事件;Microsoft 的實作完整支援 W3C 標準,並加入一些更方便使用 XML 的額外特性。
使用 XML DOM 的起點,是建立解析器物件的實例。Microsoft 透過 Msxml.dll 中的一組標準 COM 介面來暴露 DOM。取得方式有兩種:安裝 Internet Explorer 5.0(內含 MSXML 解析器),或直接下載可再散布的 Microsoft XML Parser。若用 VBScript 於網頁端,可用 CreateObject;若在 ASP 中,則用 Server.CreateObject;若在 Visual Basic 中,則先設定對 MSXML 類庫的參考。
Set objParser = CreateObject("Microsoft.XMLDOM")
Set objParser = Server.CreateObject("Microsoft.XMLDOM")
Dim xDoc As MSXML.DOMDocument
Set xDoc = New MSXML.DOMDocument
取得有效參考後,用 Load 方法開啟檔案。解析器可從本機磁碟、UNC 路徑或 URL 載入 XML:
If xDoc.Load("C:\My Documents\cds.xml") Then
' 文件載入成功,接下來做些有趣的事
Else
' 文件載入失敗
End If
預設情況下載入是非同步的,可透過布林屬性 Async 改變。若設為 True,就必須在存取文件前先檢查 ReadyState 屬性,或善用 DOMDocument 的事件通知。若要從 URL 開啟,網址前需加 https:// 前綴。
xDoc.async = False
If xDoc.Load("https://www.develop.com/hp/brianr/cds.xml") Then
' 載入成功
Else
' 載入失敗
End If
文件載入可能因檔名無效或 XML 本身格式有誤而失敗。預設情況下解析器會驗證 DTD 或架構;若把 ValidateOnParse 設為 False 則可略過驗證,但這並非好習慣,因為錯誤的文件會導致程式出錯,甚至把無效資料丟給使用者。無論哪一種失敗,都能透過 ParseError 物件取得詳細錯誤資訊:
Dim xDoc As MSXML.DOMDocument
Set xDoc = New MSXML.DOMDocument
If xDoc.Load("C:\My Documents\cds.xml") Then
' 載入成功
Else
Dim strErrText As String
Dim xPE As MSXML.IXMLDOMParseError
Set xPE = xDoc.parseError
With xPE
strErrText = "你的 XML 文件載入失敗,原因如下。" & vbCrLf & _
"錯誤編號: " & .errorCode & ": " & .reason & _
"行號: " & .Line & vbCrLf & _
"行內位置: " & .linepos & vbCrLf & _
"檔案位置: " & .filepos & vbCrLf & _
"原始文字: " & .srcText & vbCrLf & _
"文件 URL: " & .url
End With
MsgBox strErrText, vbExclamation
End If
Set xPE = Nothing
載入後,多數時間你會透過 IXMLDOMNode 介面讀寫個別節點。解析器支援約 13 種節點型別,可用 NodeType 或 NodeTypeString 取得型別資訊。從文件參考的 ChildNodes 屬性出發,就能由上而下抵達所有節點,並用 HasChildNodes 判斷是否有子節點,再搭配 ParentNode 回溯父節點。
由於 XML 天生是階層結構,寫一個遞迴例程遍歷整份文件相對容易。以下範例用 LoadDocument 開啟文件,再交由 DisplayNode 遞迴走訪:
Public Sub LoadDocument()
Dim xDoc As MSXML.DOMDocument
Set xDoc = New MSXML.DOMDocument
xDoc.validateOnParse = False
If xDoc.Load("C:\My Documents\sample.xml") Then
DisplayNode xDoc.childNodes, 0
Else
' 載入失敗,請參閱前述錯誤資訊
End If
End Sub
Public Sub DisplayNode(ByRef Nodes As MSXML.IXMLDOMNodeList, ByVal Indent As Integer)
Dim xNode As MSXML.IXMLDOMNode
Indent = Indent + 2
For Each xNode In Nodes
If xNode.nodeType = NODE_TEXT Then
Debug.Print Space$(Indent) & xNode.parentNode.nodeName & _
":" & xNode.nodeValue
End If
If xNode.hasChildNodes Then
DisplayNode xNode.childNodes, Indent
End If
Next xNode
End Sub
DisplayNode 用 HasChildNodes 決定是否再呼叫自己,直到走完整棵樹;你也可用 Level 屬性並檢查是否大於 0 來輔助判斷。掌握這套節點遍歷的骨架,你就能自由地在 XML 文件中讀取任何感興趣的資料了。