DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
ASP 中的 XML 操作類:用 XMLDOMDocument 封裝 Microsoft.XMLDOM
編輯:XML詳解     

前言

在傳統 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 的長週期程序中累積資源。

核心方法一覽

  • Create(RootElementName, XslUrl):建立新文件,會依序寫入 XML 宣告(含 encoding 參數)、xml-stylesheet 處理指令,再掛上根元素,並回傳根節點。若 RootElementName 傳入空字串,預設使用 Root。
  • Open(XMLSourceFile):以同步方式(async = False)載入既有文件,成功後記錄檔名並回傳 True。
  • Close():清掉節點參考與狀態旗標,等同於「卸載」。
  • getNodeText(NodeOBJ):讀取節點文字內容。參數可以是節點物件,也可以是節點名稱字串;傳 Null 時取用目前預設的 fNode。取得元素節點會更新 fNode,取得屬性則更新 fANode。
  • InsertElement(BefElementOBJ, ElementName, ElementText, IsFirst, IsCDATA):在指定節點下新增子元素。IsFirst 決定插在第一位還是接在最後,IsCDATA 決定文字是否包成 CDATA 區段,成功後回傳新節點並把它設為目前節點。
  • setAttributeNode(ElementOBJ, AttributeName, AttributeText):寫入或修改屬性。若同名屬性已存在就直接改值,否則先 createAttribute 再掛上去,回傳該屬性節點。
  • UpdateNodeText(ElementOBJ, NewText, IsCDATA):更新元素文字。以 CDATA 模式處理時,會判斷原本的第一個子節點是否已是 CDATA 區段,據以決定「取代」或「附加」。
  • getElementNode(ElementName, testValue):以 XPath 搭配前置斜線組出查詢條件,找出第一個符合的節點;若命中的是純文字節點,還會沿著 parentNode 往上回溯到對應的 baseName。
  • removeChild / ClearNode / removeAttributeNode:分別負責刪除子節點、清空節點內容、移除單一屬性。
  • Save() / SaveAs(SaveFileName):前者寫回 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 時仍會發生覆蓋問題,這部分需要另外處理。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved