DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
用 XMLHTTP 打造 Web 客戶端:C# 與 ASP 的 XML 協定實作
編輯:AJAX詳解     

這裡談的不是什麼新技術,重點在於達成設計目的:讓客戶端分擔一部分工作,簡化複雜的腳本處理(例如加密運算)。

先定協定,再寫程式

不管用什麼樣的客戶端,第一件事都是確定雙方遵守的協定——也就是資料怎麼設定、怎麼取得。本例的伺服器端是 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。

C# 客戶端

以下假設伺服器回應的 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 是否解析成功,最後才讀協定層的錯誤碼。三層各自代表不同性質的失敗——網路不通、回應格式錯亂、業務邏輯錯誤——混在一起處理,除錯時會非常痛苦。

ASP 伺服器端

<% 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> 結構只是拋磚引玉——真正重要的是把「錯誤碼 + 錯誤描述 + 版本號」這三件事講清楚,讓任何語言寫成的客戶端都能一致地判斷結果。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved