在傳統 ASP(VBScript)環境中處理 XML,通常要在每一頁重複寫一遍「建立 DOM 物件、抓取遠端內容、處理編碼、掛載 XPath、遍歷節點」的流程。把這些步驟收攏成一個可重複使用的類別,是讓程式碼變乾淨最直接的做法。以下是一個名為 XMLInfo 的完整實作(Version 1.0)。
parseError 資訊(原因、行號、位置、來源文字)。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 時使用 For i = 0 To NodeCount - 1,所以外部迴圈從 0 開始;但寫在 XPath 字串內部的位置謂詞(如 item[1])仍是以 1 為起點。這兩個索引基準不同,混用是常見的取錯資料原因。
類別已在 Class_Terminate 中把 DOM 與各節點物件設為 Nothing,呼叫端只要 Set objXML = Nothing 即可,不必逐一善後。
這個版本的 XMLInfo 把「抓取 → 轉碼 → 載入 → 查詢 → 取值」串成一條順暢的管線,讓呼叫端能用宣告式的語句完成工作。若要再往前推進,可以考慮加入快取機制避免重複抓取、把錯誤資訊改為收集到集合而非直接輸出,以及提供 xmlDoc.validateOnParse = True 時的 schema 驗證入口。