在傳統 ASP(VBScript)環境中,若想把 XML 當成設定檔或小型資料庫來讀寫,最直接的途徑就是呼叫微軟的 Microsoft.XMLDOM 元件。原生 DOM 介面功能完整但瑣碎,每個專案都得重寫一遍「開檔、找節點、改值、存檔、錯誤處理」的樣板。本文介紹的 XMLDOMDocument 類別,正是把這套流程收攏成一個可重複使用的元件。
類別用四個私有變數維護狀態:fNode 與 fANode 分別指向「目前所在的元素節點」與「目前所在的屬性節點」,方便連續操作時不必每次重寫完整路徑;fErrInfo 保存最近一次解析失敗的描述;fFileName 記住開啟過的路徑,之後只要呼叫 Save 就能原地寫回;fOpen 則是檔案是否處於開啟狀態的旗標。
Private Sub Class_Initialize()
Set XmlDom = CreateObject("Microsoft.XMLDOM")
XMLDom.preserveWhiteSpace = True
Set fNode = Nothing
Set fANode = Nothing
fErrInfo = ""
fFileName = ""
fOpen = False
End Sub
Private Sub Class_Terminate()
Set fNode = Nothing
Set fANode = Nothing
Set XMLDom = Nothing
fOpen = False
End Sub
初始化時特別把 preserveWhiteSpace 設為 True,也就是保留文件中原有的縮排與換行;若你希望輸出結果更精簡,把它改成 False 即可。終結程序則負責釋放所有物件參考,避免在 IIS 的長週期程序中累積資源。
xml-stylesheet 處理指令,再掛上根元素,並回傳根節點。若 RootElementName 傳入空字串,預設使用 Root。async = False)載入既有文件,成功後記錄檔名並回傳 True。fNode。取得元素節點會更新 fNode,取得屬性則更新 fANode。IsFirst 決定插在第一位還是接在最後,IsCDATA 決定文字是否包成 CDATA 區段,成功後回傳新節點並把它設為目前節點。createAttribute 再掛上去,回傳該屬性節點。parentNode 往上回溯到對應的 baseName。fFileName,後者另存新檔,兩者都用 On Error Resume Next 搭配 Err.Number 判斷結果。整個類別能如此簡潔,關鍵在於私有屬性 ChildNode。它接受「父節點」與「要找的節點」兩個參數,並容忍各種傳入型態:傳 Null 時回傳目前預設節點;傳物件時直接回傳該物件;傳字串時則視情況用 selectSingleNode 組出 //name、./name 或 ./@name 三種路徑。第三個參數 IsAttributeNode 用來區分要找的是元素還是屬性。
Public Property Get ChildNode(ByVal ElementOBJ, ByVal ChildNodeObj, ByVal IsAttributeNode)
Dim Element
Set ChildNode = Nothing
If IsNull(ChildNodeObj) Then
If IsAttributeNode = False Then Set ChildNode = fNode Else Set ChildNode = fANode
Exit Property
ElseIf IsObject(ChildNodeObj) Then
Set ChildNode = ChildNodeObj
Exit Property
End If
...
End Property
正因為每個公開方法開頭都先跑一次 ChildNode,呼叫端因此可以隨意混用節點物件、節點名稱,或乾脆什么都不給,大幅降低了使用門檻。
私有函式 IsError 檢查 XMLDom.ParseError.errorcode,不為 0 時把錯誤碼、原因、URL、行號、檔案位置與出錯的原始文字拼成一段 HTML,存入 fErrInfo,再由 ErrInfo 屬性對外公開;XMLText 屬性則可輸出指定節點(或整份文件)的 XML 字串。
這個類別的設計取向很明確:用「預設節點」的概念換取程式碼的精簡,適合中小型站台拿 XML 當設定檔或輕量資料儲存。要留意的是,它並未提供任何鎖定或交易機制,多人同時寫入同一份 XML 時仍會發生覆蓋問題,這部分需要另外處理。