本文是一篇實例講解的文章。作為一個普通的程序員,我深知,一個優秀的例程,對于正在學習編程的人是多么的有幫助。本文中使用的例程,是一個聯系信息管理程序,我也是寫來以方便自己和朋友們互相聯系用的。但麻雀雖小,五臟俱全,相信對正在學習ASP+XML編程的朋友們,還是具備一定的參考價值的。
讀者可以通過此實例,了解在ASP(Active Server Page)中如何操縱XML文件,并進行數據的各種處理,包括XML節點的建立、修改、刪除和保存等等。文中涉及到的技術包括ASP,VBScript,DOM,XML和XSL等。
本文未對使用到的技術進行深入的理論介紹,因此,讀者需要具備一定的相關知識,尤其是對ASP、XML和DOM應該有一定的了解。通讀本文,并參考源代碼,相信讀者一定可以熟練地掌握XML編程。 一、程序說明
例程基于B/S結構,使用XML文件存儲聯系信息,然后通過一個VBScript寫的Class,使用DOM,對XML文件中的聯系信息進行各種操作。
例程提供的代碼采用了統一的命名規范,主要包括:用三個字母的縮寫說明變量類型,如數字類型——int,字符串類型——str,對象——obj,等等,雖然在ASP/VBScript中,不區分數據類型,但使用明顯的數據類型說明,對程序的編寫和維護還是很有意義的;使用有意義的變量名稱,如XMLDocument對象,定義為objXmlDoc,等等,同樣,這樣做的也是為了更好地編寫和維護程序。
此程序可以分為后臺數據處理和前臺界面表現兩部分。
程序后臺,使用VBScript編寫了一個Class,這是在VBScript5.0版中提供的新特性。雖然這里Class的概念和真正的面向對象相去甚遠,但是,在ASP中合理地使用Class,還是可以在一定程度上提高程序的運行效率和可維護性。
前臺表現,使用XSL對XML文件中的數據進行了格式化,然后以HTML的形式輸出到客戶端,充分體現了XML技術帶來的靈活性與可定制性。格式化的過程放在了服務器端,使用ASP程序完成,這樣,客戶端得到的是經過格式化之后的HTML信息,避免了兼容性問題的出現。
當然,程序對于具體的操作細節未作非常嚴格的檢驗,比如聯系信息必填項的檢查,但是,對于在ASP中使用DOM操作XML的有關部分,程序提供了完整的示例代碼。 二、XML文件說明(persons.xml)
例程中使用到的XML文件結構十分簡單,并且沒有定義相關的Schema或者DTD,因為,對于此程序這是不必要的。當然,如果讀者愿意自己定義一個的話,也不會對程序的運行產生影響。
程序的數據結構定義如下,Persons集合,它包含多個Person對象,每一個Person對象包括姓名Name、英文名Nick、手機Mobile、電話Tel、電子郵件Email、騰訊QQ和所在公司Company的屬性。將以上定義對應到XML文件即,Persons為根節點,Person為Persons的子節點,Name、Nick、Mobile、Tel、Email、QQ和Company為Person的子節點。
這樣,我們得到的XML文件內容如下: <?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> </Person> 讀者需要注意<?xml version="1.0" encoding="gb2312"?>這一行,XML默認不支持中文,通過設置encoding屬性,才可以使XML正確地顯示中文。讀者可以在IE5.0及以上版本的瀏覽器中訪問此文件,它會以 樹型結構把數據顯示出來。 轉自:動態網制作指南www.knowsky.com
轉自:動態網制作指南www.knowsky.com 三、格式轉換XSL文件說明(Persons.xsl)
例程中使用XSL對XMl數據進行格式化,并以HTML的形式返回到客戶端。這個過程也可以放在客戶端進行,但考慮到兼容性的問題,例程中采用了在服務器端通過ASP操縱DOM進行格式化的方法。
XSL文件的內容如下, <?xml version="1.0" encoding="gb2312"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> <xsl:template match="/Persons"> <script language="javascript"> function add() { window.open("add.asp", "add", "width=300,height=320,resize=no"); } function edit(intId) { window.open("edit.asp?id="+intId, "edit", "width=300,height=320,resize=no"); } </script> <table width="600" border="0" align="center"> <tr> <td align="right"><a href="javascript:add();" title="添加新聯系人">添加新聯系人</a> </td> </tr> </table>
<table align="center" width="680" cellspacing="1" cellpadding="2" border="0" bgcolor="#666600"> <tr class="title" bgcolor="#E5E5E5"> <td width="25"><xsl:text disable-output-escaping="yes">&</xsl:text>nbsp;</td> <td>姓名</td> <td>英文名</td> <td>手機</td> <td>電話</td> <td>Email</td> <td>QQ</td> <td>所在公司</td> </tr> <xsl:for-each select="Person"> <TR BGCOLOR="#FFFFFF"> <TD ALIGN="right"><xsl:value-of select="position()"/></TD> <TD STYLE="color:#990000"><A><xsl:attribute name="HREF">javascript:edit(’<xsl:value-of select="position()"/>’);</xsl:attribute><xsl:attribute name="title">修改信息 </xsl:attribute><xsl:value-of select="Name"/></A></TD> <TD><xsl:value-of select="Nick"/></TD> <TD><xsl:value-of select="Mobile"/></TD> <TD><xsl:value-of select="Tel"/></TD> <TD><A><xsl:attribute name="HREF">mailto:<xsl:value-of select="Email"/></xsl:attribute><xsl:value-of select="Email"/></A></TD> <TD><xsl:value-of select="QQ"/></TD> <TD><xsl:value-of select="Company"/></TD> </TR> </xsl:for-each> </table> </xsl:template> </xsl:stylesheet> 在服務器端的轉換使用一個函數來完成,格式化成功,返回HTML字符串,格式化失敗,打印出錯誤信息,如下, ’******************************************* ’ 說明:使用XSL文件格式化XML文件。 ’ 作者:gwd 2002-11-05 ’ 參數:strXmlFile -- Xml文件,路徑+文件名 ’ strXslFile -- Xsl文件,路徑+文件名 ’ 返回:成功 -- 格式化后的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 ’ 捕獲transformNode方法的錯誤 FormatXml = objXml.transformNode(objXsl) If objXsl.parseError.errorCode <> 0 Then Response.Write "<br><hr>" Response.Write "Error Code: " & objXsl.parseError.errorCode Response.Write "<br>Error Reason: " & objXsl.parseError.reason Response.Write "<br>Error Line: " & objXsl.parseError.line FormatXml = "<span class=""alert"">格式化XML文件錯誤!</span>" End If Else Response.Write "<br><hr>" Response.Write "Error Code: " & objXsl.parseError.errorCode Response.Write "<br>Error Reason: " & objXsl.parseError.reason Response.Write "<br>Error Line: " & objXsl.parseError.line FormatXml = "<span class=""alert"">裝載XSL文件錯誤!</span>" End If Else Response.Write "<br><hr>" Response.Write "Error Code: " & objXml.parseError.errorCode Response.Write "<br>Error Reason: " & objXml.parseError.reason Response.Write "<br>Error Line: " & objXml.parseError.line FormatXml = "<span class=""alert"">裝載XML文件錯誤!</span>" End If Set objXsl = Nothing Set objXml = Nothing End Function
轉自:動態網制作指南www.knowsky.com [page_break]四、操作Xml數據的Cls_Person類說明(clsPerson.asp)
Cls_Person類用來完成與聯系人信息相關的各種操作,包括添加、修改和刪除等等,它使用VBScript編寫。Cls_Person包括Id、Name、Nick、Mobile、Tel、Email、QQ和Company屬性,對應于XML文件中的Person節點。Cls_Person包括GetInfoFromXml、AddToXml、EditToXml和DeleteFormXml四個主要方法,分別完成獲取信息,添加信息,修改信息和刪除信息四個功能。
Cls_Person的具體實現如下, ’*************************************************** ’ 說明:Person類 ’ 作者:gwd 2002-11-06 ’ 引用:pub/constpub.asp ’*************************************************** Class Cls_Person Private m_intId ’ Id,對應Person節點在Persons集合中的位置 Private m_strName ’ 姓名 Private m_strNick ’ 英文名 Private m_strMobile ’ 手機 Private m_strTel ’ 電話 Private m_strEmail ’ 電子郵件 Private m_strQQ ’ QQ號 Private m_strCompany ’ 所在公司 Private m_strError ’ 出錯信息 ’ 類初始化 Private Sub Class_Initialize() m_strError = "" m_intId = -1 End Sub ’ 類釋放 Private Sub Class_Terminate() m_strError = "" End Sub ’-----讀寫各個屬性--------------------------- Public Property Get Id Id = m_intId End Property Public Property Let Id(intId) m_intId = intId End Property Public Property Get Name Name = m_strName End Property Public Property Let Name(strName) m_strName = strName End Property Public Property Get Nick Nick = m_strNick End Property Public Property Let Nick(strNick) m_strNick = strNick End Property Public Property Get Mobile Mobile = m_strMobile End Property Public Property Let Mobile(strMobile) m_strMobile = strMobile End Property Public Property Get Tel Tel = m_strTel End Property Public Property Let Tel(strTel) m_strTel = strTel End Property Public Property Get Email Email = m_strEmail End Property Public Property Let Email(strEmail) m_strEmail = strEmail End Property Public Property Get QQ QQ = m_strQQ End Property Public Property Let QQ(strQQ) m_strQQ = strQQ End Property Public Property Get Company Company = m_strCompany End Property Public Property Let Company(strCompany) m_strCompany = strCompany End Property ’----------------------------------------------- ’ 獲取錯誤信息 Public Function GetLastError() GetLastError = m_strError End Function ’ 私有方法,添加錯誤信息 Private Sub AddErr(strEcho) m_strError = m_strError + "<Div CLASS=""alert"">" & strEcho & "</Div>" End Sub ’ 清除錯誤信息 Public Function ClearError() m_strError = "" End Function ’ 從Xml中讀取指定節點的數據,并填充各個屬性 ’ 需要首先設置Id Public Function GetInfoFromXml(objXmlDoc) Dim objNodeList Dim I ClearError If objXmlDoc Is Nothing Then GetInfoFromXml = False AddErr "Dom對象為空值" Exit Function End If If CStr(m_intId) = "-1" Then GetInfoFromXml = False AddErr "未正確設置聯系人對象的ID屬性" 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 m_strMobile = objNodeList(I).selectSingleNode("Mobile").Text m_strTel = objNodeList(I).selectSingleNode("Tel").Text m_strEmail = objNodeList(I).selectSingleNode("Email").Text m_strQQ = objNodeList(I).selectSingleNode("QQ").Text m_strCompany = objNodeList(I).selectSingleNode("Company").Text GetInfoFromXml = True Else GetInfoFromXml = False AddErr "獲取聯系信息發生錯誤" Set objNodeList = Nothing Exit Function End If Set objNodeList = Nothing End Function ’ 添加信息到XML文件中 ’ 需要首先設置好要填充的屬性 Public Function AddToXml(objXmlDoc) Dim objPerson, objNode ClearError If objXmlDoc Is Nothing Then AddToXml = False AddErr "Dom對象為空值" Exit Function End If ’ 創建Person節點 Set objPerson = objXmlDoc.createElement("Person") objXmlDoc.documentElement.appendChild objPerson ’ 創建各個子節點 ’----------------------------------------------------- [page_break] Set objNode = objXmlDoc.createElement("Name") objNode.Text = m_strName objPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Nick") objNode.Text = m_strNick objPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Mobile") objNode.Text = m_strMobile objPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Tel") objNode.Text = m_strTel objPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Email") objNode.Text = m_strEmail objPerson.appendChild objNode Set objNode = objXmlDoc.createElement("QQ") objNode.Text = m_strQQ objPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Company") objNode.Text = m_strCompany objPerson.appendChild objNode ’----------------------------------------------------- Set objNode = Nothing Set objPerson = Nothing On Error Resume Next objXmlDoc.save Server.MapPath(C_XMLFILE) ’保存XML文件 If Err.Number = 0 Then AddToXml = True Else AddToXml = False AddErr Err.Description End If End Function ’ 從XML文件中刪除數據 ’ 需要首先設置Id Public Function DeleteFromXml(objXmlDoc) Dim objNodeList, objNode ClearError If objXmlDoc Is Nothing Then DeleteFromXml = False AddErr "Dom對象為空值" Exit Function End If If CStr(m_intId) = "-1" Then DeleteFromXml = False AddErr "未正確設置聯系人對象的ID屬性" Exit Function End If Set objNodeList = objXmlDoc.getElementsByTagName("Person") If objNodeList.length - m_intId < 0 Then DeleteFromXml = False AddErr "未找到相應的聯系人" Set objNodeList = Nothing Exit Function End If On Error Resume Next Set objNode = objXmlDoc.documentElement.removeChild(objNodeList(intId-1)) If objNode Is Nothing Then DeleteFromXml = False AddErr "刪除聯系人失敗" Set objNodeList = Nothing Exit Function Else objXmlDoc.save Server.MapPath(C_XMLFILE) End If Set objNode = Nothing Set objNodeList = Nothing If Err.Number = 0 Then DeleteFromXml = True Else DeleteFromXml = False AddErr Err.Description End If End Function ’ 修改XML文件中的數據 ’ 需要首先設置好Id Public Function EditToXml(objXmlDoc) Dim objPersonList, objOldPerson, objNewPerson, objNode ClearError If objXmlDoc Is Nothing Then EditToXml = False AddErr "Dom對象為空值" Exit Function End If If CStr(m_intId) = "-1" Then EditToXml = False AddErr "未正確設置聯系人對象的ID屬性" Exit Function End If Set objPersonList = objXmlDoc.getElementsByTagName("Person") If objPersonList.length - m_intId < 0 Then DeleteFromXml = False AddErr "未找到相應的聯系人" Set objPersonList = Nothing Exit Function End If Set objOldPerson = objPersonList(m_intId-1) ’ 要修改的舊節點 Set objNewPerson = objXmlDoc.createElement("Person") ’ 用來替換舊節點的新節點 Set objNode = objXmlDoc.createElement("Name") objNode.Text = m_strName objNewPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Nick") objNode.Text = m_strNick objNewPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Mobile") objNode.Text = m_strMobile objNewPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Tel") objNode.Text = m_strTel objNewPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Email") objNode.Text = m_strEmail objNewPerson.appendChild objNode Set objNode = objXmlDoc.createElement("QQ") objNode.Text = m_strQQ objNewPerson.appendChild objNode Set objNode = objXmlDoc.createElement("Company") objNode.Text = m_strCompany objNewPerson.appendChild objNode On Error Resume Next ’ 進行替換 Set objNode = objXmlDoc.documentElement.replaceChild(objNewPerson, objOldPerson) If objNode Is Nothing Then EditToXml = False AddErr "修改聯系人失敗" Set objOldPerosn = Nothing Set objNewPerson = Nothing Set objPersonList = Nothing Exit Function Else objXmlDoc.save Server.MapPath(C_XMLFILE) End If Set objOldPerson = Nothing Set objNewPerson = Nothing Set objPersonList = Nothing If Err.Number = 0 Then EditToXml = True Else EditToXml = False AddErr Err.Description End If End Function End Class [page_break] 五、程序首頁(default.asp)
調用相應的包含文件和公共函數,格式化XML文件,并進行顯示。可以看到,頁面Title是可定制的,公共的頭部和尾部都做成了相應的包含文件。C_TITLE、C_XMLFILE和C_XSLFILE為公共常量,在constpub.asp文件中定義,至于它們的意義,相信讀者可以很容易地明白。這里調用了上面定義的FormatXml函數。 <% Option Explicit ’*********************************************** ’ 說明:通訊錄 ’ 作者:gwd 2002-11-05 ’*********************************************** %> <!--#include file="pub/funcxml.asp"--> <!--#include file="pub/constpub.asp"--> <HTML> <HEAD> <TITLE><% = C_TITLE %></TITLE> <META HTTP-EQUIV="content-type" CONTENT="text/html;charset=GB2312"/> <link rel="stylesheet" href="contact.css" type="text/css"> </HEAD> <BODY> <!--#include file="pub/header.asp"--> <% = FormatXml(C_XMLFILE, C_XSLFILE) %> <br> <!--#include file="pub/footer.asp"--> </BODY> </HTML> 六、添加、修改和刪除XML中的信息
我們知道,在Cls_Person中已經定義了相應的方法,因此,在各個文件中,只需要調用對應的方法即可。添加信息的文件為add.asp,修改信息的文件為edit.asp,刪除信息的文件為delete.asp,我們僅以add.asp文件為例進行說明。其中的CheckStrInput和CheckStrOutput函數,用來格式化用戶的輸入和輸出字符串。 <% Option Explicit ’*********************************************** ’ 說明:37080308通訊錄 ’ 作者:gwd 2002-11-05 ’*********************************************** %> <!--#include file="pub/funcxml.asp"--> <!--#include file="pub/constpub.asp"--> <!--#include file="pub/funcpub.asp"--> <!--#include file="pub/class/clsPerson.asp"--> <% Dim objXml, objPerson Dim strErr Set objXml = Server.CreateObject("MSXML2.DOMDocument") Set objPerson = New Cls_Person ’ 生成Cls_Person對象 If Request.Form("btnOk") <> "" Then If LoadXmlDoc(objXml, C_XMLFILE, False, strErr) Then ’ 裝載XML文件 ’ 給相應的屬性賦值 objPerson.Name = CheckStrInput(Request.Form("txtName")) objPerson.Nick = CheckStrInput(Request.Form("txtNick")) objPerson.Mobile = CheckStrInput(Request.Form("txtMobile")) objPerson.Tel = CheckStrInput(Request.Form("txtTel")) objPerson.Email = CheckStrInput(Request.Form("txtEmail")) objPerson.QQ = CheckStrInput(Request.Form("txtQQ")) objPerson.Company = CheckStrInput(Request.Form("txtCompany")) If Not objPerson.AddToXml(objXml) Then ’ 調用Cls_Person類的AddToXml方法,添加數據 AddErr strErr, objPerson.GetLastError Else AddErr strErr, "添加成功" Response.Write "<script language=""javascript"">opener.location.reload();</script>" End If End If End If Set objXml = Nothing %> <HTML> <HEAD> <TITLE><% = C_TITLE %></TITLE> <META HTTP-EQUIV="content-type" CONTENT="text/html;charset=GB2312"/> <link rel="stylesheet" href="contact.css" type="text/css"> <script language="javascript"> <!-- function CheckForm() { return true; } //--> </script> </HEAD> <BODY> <% = strErr %> <div class="title">添加聯系信息</div> <form name="form1" method="post" action="add.asp" onsubmit="return CheckForm()"> <table align="center" width="100%" cellspacing="1" cellpadding="2" border="0" bgcolor="#666600"> <tr bgcolor="#ffffff"> <td width="25%" bgcolor="#e5e5e5" align="right"><b>姓名:</b></td> <td width="75%"><input type="text" name="txtName" size="25" class="input" value="<%=CheckStrOutput(objPerson.Name)%>"></td> </tr> <tr bgcolor="#ffffff"> <td bgcolor="#e5e5e5" align="right"><b>英文名:</b></td> <td><input type="text" name="txtNick" size="25" class="input" value="<%=CheckStrOutput(objPerson.Nick)%>"></td> </tr> <tr bgcolor="#ffffff"> <td bgcolor="#e5e5e5" align="right"><b>手機:</b></td> <td><input type="text" name="txtMobile" size="25" class="input" value="<%=CheckStrOutput(objPerson.Mobile)%>"></td> </tr> <tr bgcolor="#ffffff"> <td bgcolor="#e5e5e5" align="right"><b>電話:</b></td> <td><input type="text" name="txtTel" size="25" class="input" value="<%=CheckStrOutput(objPerson.Tel)%>"></td> </tr> <tr bgcolor="#ffffff"> <td bgcolor="#e5e5e5" align="right"><b>Email:</b></td> <td><input type="text" name="txtEmail" size="25" class="input" value="<%=CheckStrOutput(objPerson.Email)%>"></td> </tr> <tr bgcolor="#ffffff"> <td bgcolor="#e5e5e5" align="right"><b>QQ:</b></td> <td><input type="text" name="txtQQ" size="25" class="input" value="<%=CheckStrOutput(objPerson.QQ)%>"></td> </tr> <tr bgcolor="#ffffff"> <td bgcolor="#e5e5e5" align="right"><b>所在公司:</b></td> <td><input type="text" name="txtCompany" size="25" class="input" value="<%=CheckStrOutput(objPerson.Company)%>"></td> </tr> </table> <br> <div align="center"> <input type="submit" name="btnOk" value="提交"> <input type="button" name="btnClose" value="關閉" onclick="javascript:return window.close();"> </div> </form> </BODY> </HTML> <% Set objPerson = Nothing %> 七、總結
到此,我們的聯系信息管理程序就大功告成了。怎么樣,感覺如何,應該來說還是相當簡單的吧。當然了,這個例程還有許多可以改進的地方,我這里也只不過是拋磚引玉,希望讀者在掌握了XML編程之后,自行修改完善吧。
此例程已經在我本機(Windows Server 2000、IIS5.0和IE6.0)和網上進行了測試,都能夠正常運行。
|