對正在學習程式設計的人而言,一個優秀的範例往往有事倍功半之效。本文以一個聯絡資訊管理程式為例——它雖小,卻五臟俱全,相信對學習 ASP + XML 編程的朋友有一定參考價值。透過這個實例,你能了解如何在 ASP 中操作 XML 檔,進行節點的建立、修改、刪除與保存等各種處理,其中涉及 ASP、VBScript、DOM、XML 與 XSL 等技術。由於本文不深入介紹理論,建議讀者對這些技術已有基礎認識。
範例基於 B/S 結構,用 XML 檔儲存聯絡資訊,再透過一個以 VBScript 撰寫的 Class,借助 DOM 對資訊進行各種操作。程式採用了統一的命名規範:以三字母縮寫標示變數類型(如 int、str、obj),並使用具意義的變數名稱(如把 XMLDocument 物件命名為 objXMLDoc),以便編寫與維護。
程式分為後台資料處理與前台界面表現兩部分。後台用 VBScript 撰寫了一個 Class——這是 VBScript 5.0 提供的新特性,合理運用可在一定程度上提升效率與可維護性。前台則用 XSL 格式化 XML 資料,再以 HTML 輸出到客戶端,展現了 XML 帶來的靈活性;格式化過程放在伺服器端以 ASP 完成,客戶端拿到的即是格式化後的 HTML,避免了相容性問題。
範例的 XML 結構十分簡單,且沒有定義 Schema 或 DTD,因為對此程式並無必要。資料結構為:Persons 集合包含多個 Person 物件,每個 Person 含姓名 Name、英文名 Nick、手機 Mobile、電話 Tel、電子郵件 Email、騰訊 QQ 與公司 Company 等子節點:
<?XML version="1.0" encoding="gb2312"?>
<Persons>
<Person>
<Name>小東</Name>
<Nick>gwd</Nick>
<Mobile>139XXXXXXXX</Mobile>
<Tel>XXXXXXXX</Tel>
<Email>gwd@chinaren.com</Email>
<QQ>7066015</QQ>
<Company>XXX</Company>
</Person>
</Persons>
要注意 <?xml version="1.0" encoding="gb2312"?> 這一行:XML 預設不支援中文,透過設定 encoding 屬性才能正確顯示中文。你可以在 IE5.0 以上版本的瀏覽器中直接開啟此檔,它會以樹形結構把資料呈現出來。
範例用 XSL 格式化 XML 資料並回傳 HTML。考量到相容性,格式化在伺服器端透過 ASP 操作 DOM 完成。XSL 檔以 <xsl:template match="/Persons"> 為樣式主體,用 <xsl:for-each select="Person"> 逐一輸出每筆聯絡人,並以 <xsl:value-of> 填入姓名、英文名、手機等欄位,同時為姓名加上可點擊修改的連結、為 Email 加上 mailto 連結。
伺服器端的轉換由一個函式完成,成功時回傳 HTML 字串,失敗時印出錯誤資訊:
Function FormatXml(strXMLFile, strXslFile)
Dim objXML, objXsl
strXmlFile = Server.MapPath(strXMLFile)
strXslFile = Server.MapPath(strXslFile)
Set objXml = Server.CreateObject("MSXML2.DOMDocument")
Set objXsl = Server.CreateObject("MSXML2.DOMDocument")
objXML.Async = False
If objXml.Load(strXMLFile) Then
objXsl.Async = False
objXsl.ValidateonParse = False
If objXsl.Load(strXslFile) Then
On Error Resume Next
FormatXml = objXML.transformNode(objXsl)
If objXsl.parseError.errorCode <> 0 Then
FormatXml = "<span class=""alert"">格式化XML文件錯誤!</span>"
End If
Else
FormatXML = "<span class=""alert"">裝載XSL文件錯誤!</span>"
End If
Else
FormatXml = "<span class=""alert"">裝載XML文件錯誤!</span>"
End If
Set objXsl = Nothing
Set objXML = Nothing
End Function
Cls_Person 類負責聯絡人資訊的各種操作,包含 Id、Name、Nick、Mobile、Tel、Email、QQ、Company 等屬性,對應 XML 中的 Person 節點,並提供 GetInfoFromXml、AddToXml、EditToXml、DeleteFromXml 四個主要方法,分別完成獲取、新增、修改與刪除。核心邏輯如下:
' 從XML讀取指定節點資料並填入各屬性,需先設定Id
Public Function GetInfoFromXml(objXMLDoc)
Dim objNodeList, I
ClearError
If objXMLDoc Is Nothing Then
AddErr "Dom對象為空值" : GetInfoFromXML = False : Exit Function
End If
If CStr(m_intId) = "-1" Then
AddErr "未正確設置聯系人對象的ID屬性" : GetInfoFromXML = False : Exit Function
Else
I = m_intId - 1
End If
Set objNodeList = objXMLDoc.getElementsByTagName("Person")
If objNodeList.length - m_intId >= 0 Then
On Error Resume Next
m_strName = objNodeList(I).selectSingleNode("Name").Text
m_strNick = objNodeList(I).selectSingleNode("Nick").Text
' ...其餘屬性同理讀取
GetInfoFromXML = True
Else
AddErr "獲取聯系信息發生錯誤" : GetInfoFromXML = False
End If
Set objNodeList = Nothing
End Function
新增資料時,先 createElement 建立 Person 節點,逐一建立 Name、Nick、Mobile 等子節點並 appendChild 掛上,最後用 objXmlDoc.save 存檔。刪除則以 removeChild 移除定位到的 Person 節點後存檔。修改的做法較特別:先建立一個全新的 Person 節點填入新值,再用 replaceChild 把它替換掉舊節點,最後存檔。每個方法都以 m_strError 累積錯誤訊息,並透過 GetLastError 對外提供。
首頁呼叫 FormatXml 函式格式化並顯示 XML,頁面標題可自訂,頭尾各自做成包含檔。C_TITLE、C_XMLFILE 與 C_XSLFILE 是定義在 constpub.ASP 中的公共常數:
<% Option Explicit %>
<!--#include file="pub/funcXML.ASP"-->
<!--#include file="pub/constpub.ASP"-->
<Html>
<HEAD>
<TITLE><% = C_TITLE %></TITLE>
</HEAD>
<BODY>
<% = FormatXml(C_XMLFILE, C_XSLFILE) %>
</BODY>
</Html>
由於相關方法已在 Cls_Person 中定義好,各頁面只需呼叫對應方法即可。以新增頁 add.asp 為例,它先載入 XML,把表單輸入逐一賦值給 objPerson 的屬性,再呼叫 AddToXml 完成寫入。其中的 CheckStrInput 與 CheckStrOutput 函式分別用來格式化使用者的輸入與輸出字串,避免資料寫入時破壞 XML 結構。
<%
Dim objXML, objPerson, strErr
Set objXml = Server.CreateObject("MSXML2.DOMDocument")
Set objPerson = New Cls_Person
If Request.Form("btnOk") <> "" Then
If LoadXmlDoc(objXml, C_XMLFILE, False, strErr) Then
objPerson.Name = CheckStrInput(Request.Form("txtName"))
' ...其餘屬性同理賦值
If Not objPerson.AddToXml(objXml) Then
AddErr strErr, objPerson.GetLastError
Else
AddErr strErr, "添加成功"
End If
End If
End If
Set objXML = Nothing
%>
表單以 Asp:textbox 控制項對應姓名、英文名、手機、電話、Email、QQ、公司等欄位,並附上提交與關閉按鈕。修改頁 edit.asp 與刪除頁 delete.asp 的寫法大同小異,同樣是呼叫 Cls_Person 中對應的方法。
至此,這個聯絡資訊管理程式就大功告成了。麻雀雖小,卻完整示範了在 ASP 中透過 DOM 操作 XML 的新增、修改、刪除與格式化顯示。範例仍有許多可改進之處,例如必填欄位的檢查,讀者在掌握 XML 編程後不妨自行修改完善。此範例已在 Windows Server 2000、IIS 5.0 與 IE 6.0 環境及網路上測試,均能正常運行。