收集資料總要有一個儲存的地方。想避開資料庫伺服器帶來的一堆設定與維護問題,可以把資料暫存在 XML 裡。本文示範的骨架非常精簡:
<user> <first_name/> <last_name/> <mi/> </user>
先把範圍縮小到名字、姓氏與中間名,畫面 responsible 收集這些欄位;使用者填完且通過驗證後,流程就交棒給下一個收集步驟。為了讓後續頁面能重用,這些邏輯全部封裝進一個 ASP 類別 CUser。
類別初始化時,它會判斷請求中是否已帶著 txtUserXML(隱藏欄位傳回的既有狀態):有就載入,沒有就從 user.XML 起頭,接著把 Request.Form 與 Request.QueryString 的內容併進 DOM。
Class CUser
Private m_SQL, m_DOM
Public Property Get DOM()
Set DOM = m_DOM
End Property
Public Sub saveUser()
m_SQL.save "save_user", m_DOM
End Sub
Public Function validate()
m_DOM.loadXML "<root>" & m_SQL.validateUser(m_DOM) & "</root>"
If Not m_DOM.selectSingleNode("//error") Is Nothing Then
validate = False
Else
validate = True
End If
End Function
Private Sub collectData(dom, oCollection)
Dim nItem, node, parent_node, n, sKey
For nItem = 1 To oCollection.Count
sKey = oCollection.Key(nItem)
Set parent_node = dom.selectSingleNode("//" & sKey & "s")
If Not parent_node Is Nothing Then
For n = 1 To oCollection(sKey).Count
Set node = parent_node.selectSingleNode(sKey & _
"[string(.)='" & oCollection(sKey)(n) & "']")
If node Is Nothing Then
Set node = dom.createNode(1, sKey, "")
Set node = parent_node.appendChild(node)
End If
node.text = Coalesce(oCollection(sKey)(n), "")
Next
Else
Set node = dom.selectSingleNode("//" & sKey)
If Not node Is Nothing Then _
node.text = Coalesce(oCollection(sKey), "")
End If
Next
End Sub
Private Sub Class_Initialize()
Set m_SQL = New CSQL
Set m_DOM = Server.CreateObject("MSXML2.DOMDocument")
m_DOM.async = False
If VarType(Request("txtUserXML")) = 0 Or Request("txtUserXML") = "" Then
m_DOM.loadXML Request("txtUserXML")
Else
m_DOM.load "<root>" & Server.MapPath("user.XML") & "</root>"
End If
collectData m_DOM, Request.Form
collectData m_DOM, Request.QueryString
End Sub
Private Sub Class_Terminate()
Set m_SQL = Nothing
Set m_DOM = Nothing
End Sub
End Class
輔助用的 Coalesce 負責把空值換成預設值:
Function Coalesce(vVal, vAlt)
If vVal = "" Or VarType(vVal) = 1 Or VarType(vVal) = 0 Then
Coalesce = vAlt
Else
Coalesce = vVal
End If
End Function
collectData 的做法值得一看:它把表單欄位名稱當成節點名稱,同名節點直接覆寫文字;若對應的是重複型集合(節點名加 s 的父節點),則逐筆比對既有內容,找不到就新增。這讓同一份程式碼能同時處理單值與多值欄位。
Class CSQL
Private m_DAL, m_Stream
Public Function save(sStoredProc, oDOM)
'adVarChar = 200
m_DAL.RunSP Array(m_DAL.mp("@xml_param", 200, 8000, oDOM.XML))
End Function
Public Function validateUser(oDOM)
Set m_Stream = m_DAL.RunSPReturnStream("validate_user", Array( _
m_DAL.mp("@xml_param", 200, 8000, oDOM.XML)))
validateUser = m_Stream.ReadText(-1)
m_Stream.Close
End Function
Private Sub Class_Initialize()
Set m_DAL = Server.CreateObject("MyPkg.MyDAL")
m_DAL.GetConnection "some connection string"
Set m_Stream = Server.CreateObject("ADODB.Stream")
End Sub
Private Sub Class_Terminate()
Set m_DAL = Nothing
Set m_Stream = Nothing
End Sub
End Class
這裡的資料存取層 MyPkg.MyDAL 建立在 Fitch 與 Mather 的 DAL 元件之上(兩者都能從 MSDN 取得),負責在 SQL Server 與應用程式之間搭橋。整份 DOM 直接以 XML 字串當參數傳給預儲程序,是這個設計最省事的地方。
驗證的結果由預儲程序決定:每個必填卻沒填的欄位,都會回傳一個 error 節點。樣式表再把這些資訊轉成版面,並讓出錯的欄位標題變紅。
<xsl:template match="user">
<font>
<xsl:attribute name="color">
<xsl:choose>
<xsl:when test="//error[.='first name']">red</xsl:when>
<xsl:otherwise>black</xsl:otherwise>
</xsl:choose>
</xsl:attribute>
First Name:
</font>
<input type="text" name="first_name">
<xsl:attribute name="value">
<xsl:value-of select="first_name"/>
</xsl:attribute>
</input><br/>
...
</xsl:template>
三個欄位各用同樣的 xsl:choose 判斷對應的 error 節點是否存在,並把既有值回填到 value 屬性——使用者送出的資料不會因為一次驗證失敗而消失。頁首若出現任何 //error,則顯示紅字提示。
<%@ Language=VBScript %> <% Option Explicit Dim oUser Set oUser = New CUser If oUser.validate() Then Set oUser = Nothing Server.Transfer "NextPage.ASP" End If %> <html> <body> <form method="POST" action="GetUser.ASP" name="thisForm" id="thisForm"> <% Response.Write xslTransform(oUser.DOM, "user.xsl") %> <input type="hidden" name="txtUserXML" id="txtUserXML" value="<%=oUser.DOM.XML%>"> <input type="submit" value="Submit"> </form> </body> </html> <% Set oUser = Nothing %>
轉換本身包在一個小函式裡,順便檢查 XML 與 XSL 是否解析成功:
Function xslTransform(vXML, XSLFileName)
Dim m_XML, m_xsl
If VarType(vXML) = 8 Then
Set m_XML = Server.CreateObject("MSXML2.DOMDocument")
m_XML.async = False
m_XML.loadXML vXML
ElseIf VarType(vXML) = 9 Then
Set m_XML = vXML
End If
If m_XML.parseError.errorCode <> 0 Then _
Err.Raise vbObjectError, "XMLTransform(...)", m_XML.parseError.reason
Set m_xsl = Server.CreateObject("MSXML2.DOMDocument")
m_xsl.async = False
m_xsl.load Server.MapPath(XSLFileName)
If m_xsl.parseError.errorCode <> 0 Then _
Err.Raise vbObjectError, "XMLTransform(...)", m_xsl.parseError.reason
xslTransform = m_XML.transformNode(m_xsl)
Set m_xsl = Nothing
End Function
頁面流程很直白:建立 CUser 物件、有資料就填進去、驗證通過就轉到下一頁,否則用 XSL 轉換出帶有錯誤提示的表單。別忘了把 CUser 的 DOM 存進隱藏的 INPUT 才能跨頁保留;改成 Session 變數也可以,記得在初始化時取出即可。
這套骨架之後可以複製出無數個收集頁面。它最漂亮的地方在於輸出完全是純 HTML,不依賴任何瀏覽器專屬特性或額外樣式表;而因為邏輯都收在類別裡,版面交給 XSLT 處理,執行速度也相當快。
作者:Phillip Perkins,Ajilon Consulting 簽約顧問,經驗橫跨機器控制、用戶端/伺服器到企業內部網應用。