asp+|xml|編程
本文是一篇執行個體講解的文章。作為一個普通的程式員,我深知,一個優秀的常式,對於正在學習編程的人是多麼的有協助。本文中使用的常式,是一個聯絡資訊管理程式,我也是寫來以方便自己和朋友們互相聯絡用的。但麻雀雖小,五髒俱全,相信對正在學習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及以上版本的瀏覽器中訪問此檔案,它會以 樹型結構把資料顯示出來。
三、格式轉換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">
<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檔案。
' 參數: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
四、操作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的具體實現如下,
'***************************************************
' 引用: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
' 建立各個子節點
'-----------------------------------------------------
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
五、程式首頁(default.asp)
調用相應的包含檔案和公用函數,格式化XML檔案,並進行顯示。可以看到,頁面Title是可定製的,公用的頭部和尾部都做成了相應的包含檔案。C_TITLE、C_XMLFILE和C_XSLFILE為公用常量,在constpub.asp檔案中定義,至於它們的意義,相信讀者可以很容易地明白。這裡調用了上面定義的FormatXml函數。
<% Option Explicit
%>
<!--#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
%>
<!--#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 ""
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">
</HEAD>
<BODY>
<% = strErr %>
<div class="title">添加聯絡資訊</div>
<form name="form1" method="post" action="add.asp" >
<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="關閉" >
</div>
</form>
</BODY>
</HTML>
<%
Set objPerson = Nothing
%>
七、總結
到此,我們的聯絡資訊管理程式就大功告成了。怎麼樣,感覺如何,應該來說還是相當簡單的吧。當然了,這個常式還有許多可以改進的地方,我這裡也只不過是拋磚引玉,希望讀者在掌握了XML編程之後,自行修改完善吧。
此常式已經在我本機(Windows Server 2000、IIS5.0和IE6.0)和網上進行了測試,都能夠正常運行。