DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
XMLInfo 類別實作:用 VBScript 封裝 XML 抓取與 XPath 查詢
編輯:XML詳解     

在傳統 ASP(VBScript)環境中處理 XML,通常要在每一頁重複寫一遍「建立 DOM 物件、抓取遠端內容、處理編碼、掛載 XPath、遍歷節點」的流程。把這些步驟收攏成一個可重複使用的類別,是讓程式碼變乾淨最直接的做法。以下是一個名為 XMLInfo 的完整實作(Version 1.0)。

設計目標

  • 抓取與解析分離:透過 HTTP 取得 XML 內容,自動處理位元組到字串的編碼轉換,再載入 DOM。
  • 錯誤可見:解析失敗時能輸出完整的 parseError 資訊(原因、行號、位置、來源文字)。
  • XPath 友善:把 selectSingleNode 與 selectNodes 包成屬性,並預先將節點集合攤平成陣列,方便迴圈取值。
  • 取值便利:提供「取某節點下某子節點文字」這類高頻操作的快捷方法。

類別主體

<%
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
'''' XML information Class Version 1.0
'''' Author : Xinsoft [ Xin Yaping ]
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
Class XMLInfo

    Public encoding      '' as String
    Public NodeCount
    Public NodeArray

    Private XMLURL       '' as String
    Private xmlDoc       '' as MsXML2.DOMDocument.4.0

    Private ReadyState   '' as Integer
    Private Status       '' as Integer
    Private LoadSuccess  '' as Boolean
    Private parseError   '' as Integer

    Private curSingleNode '' as Node
    Private curNodeList   '' as NodeList
    Private curXpath      '' as String

    Private Sub Class_Initialize
        XMLURL      = ""
        encoding    = "GB2312"
        NodeCount   = 0
        ReadyState  = 0
        Status      = 0
        LoadSuccess = False
        parseError  = 0

        Set xmlDoc = CreateObject("MsXML2.DOMDocument.4.0")
    End Sub

    Private Sub Class_Terminate
        Set xmlDoc = Nothing

        If True = IsObject(NodeArray) Then
            Set NodeArray = Nothing
        End If
        If True = IsObject(curSingleNode) Then
            Set curSingleNode = Nothing
        End If
        If True = IsObject(curNodeList) Then
            Set curNodeList = Nothing
        End If
    End Sub

    '' 位元內容 → 指定編碼的字串
    Function BytesToBstr(strBody, CodeBase)
        Dim objStream
        Set objStream = Server.CreateObject("Adodb.Stream")
        objStream.Type     = 1          '' adTypeBinary
        objStream.Mode     = 3
        objStream.Open
        objStream.Write strBody
        objStream.Position = 0
        objStream.Type     = 2          '' adTypeText
        objStream.Charset  = CodeBase
        BytesToBstr = objStream.ReadText
        objStream.Close
        Set objStream = Nothing
    End Function

    '' 以 GET 抓取 XMLURL,回傳已轉碼的字串
    Public Function httpGet()
        Dim Cont
        Dim objXMLHttp

        Set objXMLHttp = Server.CreateObject("Msxml2.XMLHTTP")

        objXMLHttp.open "GET", XMLURL, False
        objXMLHttp.send()

        ReadyState = objXMLHttp.readyState
        Status     = objXMLHttp.status

        If 4 = ReadyState And 200 = Status Then
            Cont = objXMLHttp.responseBody
        Else
            Cont = ""
        End If

        Set objXMLHttp = Nothing

        Cont = BytesToBstr(Cont, encoding)
        httpGet = Cont
    End Function

    '' 解析失敗時印出完整診斷資訊
    Public Sub PrintParseErrorInfo()
        If parseError = 1 Then

            Response.Write "<P>Some error found in your XML document.</P>"

            Dim xPE
            Set xPE = xmlDoc.parseError

            Response.Write "<p>parseError.reason  = " & xPE.reason  & "</p>"
            Response.Write "<p>parseError.filepos = " & xPE.filepos & "</p>"
            Response.Write "<p>parseError.line    = " & xPE.line    & "</p>"
            Response.Write "<p>parseError.linepos = " & xPE.linepos & "</p>"
            Response.Write "<p>parseError.srcText = " & xPE.srcText & "</p>"
            Response.Write "<p>parseError.URL     = " & xPE.URL     & "</p>"

            Set xPE = Nothing

        Else
            Response.Write ""
        End If
    End Sub

    '' 設定來源網址,立即抓取並載入 DOM
    Property Let url(XMLSourceHttp)

        Dim Cont

        xmlURL = XMLSourceHttp

        xmlDoc.async          = False
        xmlDoc.validateOnParse = False

        Cont        = httpGet()
        LoadSuccess = xmlDoc.LoadXML(Cont)
        ReadyState  = xmlDoc.readyState

        If xmlDoc.parseError.errorCode <> 0 Then
            parseError = 1
        Else
            parseError = 0
        End If

    End Property

    Property Get url()
        url = XMLURL
    End Property

    '' 僅記錄當前的 XPath 字串
    Property Let Xpath(path)
        curXpath = path
    End Property

    Property Get Xpath()
        Xpath = curXpath
    End Property

    '' 單一節點查詢
    Property Let SingleNode(Xpath)
        curXpath = Xpath
        Set curSingleNode = xmlDoc.documentElement.selectSingleNode(curXpath)
    End Property

    Property Get SingleNode()
        Set SingleNode = curSingleNode
    End Property

    '' 節點集合查詢,並攤平成 NodeArray
    Property Let NodeList(Xpath)

        Dim i

        curXpath = Xpath
        Set curNodeList = xmlDoc.documentElement.selectNodes(curXpath)

        NodeCount = curNodeList.length
        ReDim NodeArray(NodeCount)
        For i = 0 To NodeCount - 1
            Set NodeArray(i) = curNodeList.item(i)
        Next

    End Property

    Property Get NodeList()
        Set NodeList = curNodeList
    End Property

    Property Get loadStat()
        loadStat = LoadSuccess
    End Property

    '' 取子節點文字
    Public Function getChildNodeValByName(objNode, ChildNodeName)
        getChildNodeValByName = objNode.selectSingleNode(ChildNodeName).text
    End Function

    '' 從 NodeArray 中取第 index 筆的子節點文字
    Property Get ChildValInList(index, ChildName)
        ChildValInList = getChildNodeValByName(NodeArray(index), ChildName)
    End Property

    '' 從目前 SingleNode 取子節點文字
    Property Get ChildVal(ChildName)
        ChildVal = getChildNodeValByName(curSingleNode, ChildName)
    End Property

    '' 直接以 XPath 取節點文字
    Property Get NodeVal(Xpath)
        NodeVal = xmlDoc.documentElement.selectSingleNode(Xpath).text
    End Property

    '' 取符合條件的節點數量
    Property Get XpathNodesLength(Xpath)
        XpathNodesLength = xmlDoc.documentElement.selectNodes(Xpath).length
    End Property

    '' 取集合中第 index 筆的文字
    Property Get NodeValInList(Xpath, index)
        NodeValInList = xmlDoc.documentElement.selectNodes(Xpath).item(index).text
    End Property

End Class
%>

呼叫範例

<% option explicit %>
<!-- #include file="../../lib/XML.ASP" -->
<%
Dim Str, i, N
Dim objXML
Set objXML = New XMLInfo

With objXML
    .url      = "https://210.77.146.223/tech/indexXML.PHP"
    .encoding = "gb2312"
End With

'' 1. 節點集合:取出所有 item,逐筆印出 title
objXML.NodeList = "/blogtech/item"
Response.Write "<p>objXML.NodeCount = " & objXML.NodeCount & "</p>" & vbCrLf

For i = 0 To objXML.NodeCount - 1
    Response.Write "<p>" & objXML.ChildValInList(i, "title") & "</p>" & vbCrLf
Next

Response.Write "<hr />Test SingleNode<hr />" & vbCrLf

'' 2. 單一節點:取該節點下的子節點文字
objXML.SingleNode = "/blogtech"
Response.Write "objXML.ChildVal(""description"") = " _
    & objXML.ChildVal("description") & vbCrLf

Response.Write "<hr />Test NodeVal<hr />" & vbCrLf

'' 3. 直接以 XPath 取值
Response.Write "objXML.NodeVal(""/blogtech/description"") = " _
    & objXML.NodeVal("/blogtech/description") & vbCrLf

Response.Write "<hr />Test XpathNodesLength and NodeValInList<hr />" & vbCrLf

'' 4. 先問數量,再按索引取值
N = objXML.XpathNodesLength("/blogtech/item/link")
Response.Write "<p>XpathNodesLength = " & N & "</p>" & vbCrLf

For i = 0 To N - 1
    Response.Write "<p>" & objXML.NodeValInList("/blogtech/item/link", i) & "</p>" & vbCrLf
Next

Set objXML = Nothing
%>

使用上的幾個要點

編碼必須對齊

httpGet() 取回的是 responseBody(原始位元組),因此一定要透過 BytesToBstr 依 encoding 屬性轉碼,否則中文會整片亂掉。類別預設 GB2312,若來源是 UTF-8,記得在設定 url 之前或之後明確指定 .encoding = "UTF-8"。

同步抓取下請確認錯誤狀態

url 是 Let 屬性,設定時就同步完成抓取與載入。因此指派之後應該檢查 loadStat,若為 False 再呼叫 PrintParseErrorInfo 取得行號與原因,這比事後猜測省事得多。

NodeArray 是 0 起算,XPath 索引是 1 起算

類別把節點攤平成 NodeArray 時使用 For i = 0 To NodeCount - 1,所以外部迴圈從 0 開始;但寫在 XPath 字串內部的位置謂詞(如 item[1])仍是以 1 為起點。這兩個索引基準不同,混用是常見的取錯資料原因。

記得清理物件

類別已在 Class_Terminate 中把 DOM 與各節點物件設為 Nothing,呼叫端只要 Set objXML = Nothing 即可,不必逐一善後。

結語

這個版本的 XMLInfo 把「抓取 → 轉碼 → 載入 → 查詢 → 取值」串成一條順暢的管線,讓呼叫端能用宣告式的語句完成工作。若要再往前推進,可以考慮加入快取機制避免重複抓取、把錯誤資訊改為收集到集合而非直接輸出,以及提供 xmlDoc.validateOnParse = True 時的 schema 驗證入口。

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