這裡談的不是什麼新技術,重點在於達成設計目的:讓客戶端分擔一部分工作,簡化複雜的腳本處理(例如加密運算)。
不管用什麼樣的客戶端,第一件事都是確定雙方遵守的協定——也就是資料怎麼設定、怎麼取得。本例的伺服器端是 IIS 5 上的 ASP 程式,所以協定是 HTTP,並在 HTTP 之上傳輸 XML。用 XML 是為了讓資料格式容易統一;既然有這樣的現成思路,沒有理由不用。
而 XMLHTTP 恰好就是基於 HTTP 傳輸 XML 的方便類別。
open(bstrMethod, bstrUrl, varAsync, bstrUser, bstrPassword)
依 bstrMethod 指定的 HTTP 方法(POST、GET 等)開啟 bstrUrl 指定的連接;varAsync 決定是否非同步;bstrUser 與 bstrPassword 是存取該網址所需的帳號密碼。
send(varBody)
送出(提交)的資料。
更完整的說明可參考 MSXML SDK。
以下假設伺服器回應的 XML 格式為 <RESPONSE><ERROR ID="0">成功</ERROR></RESPONSE>。
private MSXML2.DOMDocument40Class zXML; // 處理伺服器回應結果
private int zLastErrorCode;
private string zLastErrorDescription;
private const int OkSuccess = 0;
private int ExecuteCmd(string sCmd, string method, string ext)
{
// 依 sCmd 組出 sURL 的程式碼此處省略
try
{
zXMLHttp.open(method, sURL, false, "", "");
zXMLHttp.send(ext);
}
finally
{
if (zXMLHttp.status / 100 == 2) // 200~206 都算成功
{
zXml.loadXML(zXMLHttp.responseText);
if (zXML.parseError.errorCode != 0)
{
zLastErrorCode = ErrProtocol;
zLastErrorDescription = zXML.parseError.reason;
}
else
{
s = GetXmlNodeValue(zXML, "/RESPONSE/ERROR/@ID");
if (s.Length == 0)
{
zLastErrorCode = OkSuccess;
}
else
{
try { zLastErrorCode = Convert.ToInt32(s); }
catch { zLastErrorCode = ErrUnknown; }
}
zLastErrorDescription = GetXmlNodeValue(zXML, "/RESPONSE/ERROR");
if (zLastErrorDescription.Length == 0)
{
zLastErrorDescription =
(zLastErrorCode == OkSuccess) ? "執行成功" : "未知錯誤資訊";
}
}
}
else
{
// 伺服器出錯
zLastErrorCode = ErrService;
zLastErrorDescription = zXMLHttp.statusText;
}
}
return zLastErrorCode;
}
這段結構值得注意的地方是:錯誤處理分兩層。先看 HTTP 狀態碼(status / 100 == 2 一次涵蓋所有 2xx),再看 XML 是否解析成功,最後才讀協定層的錯誤碼。三層各自代表不同性質的失敗——網路不通、回應格式錯亂、業務邏輯錯誤——混在一起處理,除錯時會非常痛苦。
<% LANGUAGE=VBSCRIPT %>
<%
Dim oXML
Set oXML = Server.CreateObject("MsXML2.DOMDocument.4.0")
oXML.async = False
oXML.resolveExternals = False
oXML.load Request ' 載入客戶端送來的 XML
' 在這裡處理提交的 XML 資料
Set oXML = Nothing
' 回饋處理結果
Response.ContentType = "text/xml" ' 回傳 XML 是必要的
Response.CharSet = "gb2312" ' 編碼不可省略,否則會出現客戶端無法解析的非法字元
Response.Write "<?xml version=""1.0"" encoding=""gb2312"" ?>" & vbCrlf
Response.Write "<RESPONSE><VERSION>1.0.0.0</VERSION><TEST>測試內容</TEST></RESPONSE>" & vbCrlf
%>
ContentType 必須是 text/xml。少了它,客戶端的 responseXML 取不到東西,只能退回 responseText 自行解析。
CharSet 必須與 XML 宣告一致。這是最容易踩的坑:Response.CharSet 設為 gb2312,XML 宣告也必須寫 gb2312。兩者不符時,中文會變成亂碼或觸發解析錯誤,而錯誤訊息往往指向 XML 語法,讓人查錯方向。
傳輸的 XML 資料格式,說穿了就是你自己定義的協定。上面給的 <RESPONSE><ERROR ID> 結構只是拋磚引玉——真正重要的是把「錯誤碼 + 錯誤描述 + 版本號」這三件事講清楚,讓任何語言寫成的客戶端都能一致地判斷結果。