MSXML 提供了 Microsoft.XMLHTTP 物件,能完成從資料包到 Request 物件的封裝與傳送任務。本文把它的建立方式、常用方法、狀態判定與回應讀取整理成一份可查閱的筆記。
Set objXML = CreateObject("Msxml2.XMLHTTP")
' 或
Set objXML = CreateObject("Microsoft.XMLHTTP")
' 若使用 3.0 版本的 XMLHTTP,則用:
' Set xml = Server.CreateObject("MSXML2.ServerXMLHTTP")
物件建立後,先呼叫 Open 方法初始化 Request,語法如下:
poster.open http-method, url, async, userID, passWord
五個參數中前三個必填,後兩個僅在伺服器需要身份驗證時提供:
poster.send XML-data
Send 的參數型別是 Variant,可以是字串、DOM 樹或任意資料流。非同步模式下,資料包一送完就結束 Send 程序,用戶端接著做別的事;同步模式則要等伺服器確認後才返回。選擇哪一種,取決於你的頁面能否容忍等待——查詢類請求適合非同步,需要立刻拿到結果才能續行的流程則用同步。
XMLHTTP 的 readyState 屬性反映伺服器處理請求的進展,用戶端可據此設定對應的事件處理:
實務上,程式邏輯通常只在 readyState = 4 時才動手讀取回應,其餘階段一律略過。
用戶端收到回應後稍作處理,就完成了一個完整的 C/S 互動週期。回應透過三個屬性取得:
下面的例子在客戶端 JavaScript 中動態產生 XML,再用 XMLHTTP 傳出去。若改寫在伺服器端,只需調整物件的建立方式,其餘邏輯不變。
var xmlDoc = new ActiveXObject("MSXML2.DOMDocument");
flag = xmlDoc.loadXML("");
// 建立各個節點並組裝成樹狀結構
newNode = xmlDoc.createElement("編碼");
MarkNode = xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("StartMark");
newNode.text = StartMark;
MarkNode.appendChild(newNode);
newNode = xmlDoc.createElement("EndMark");
newNode.text = EndMark;
MarkNode.appendChild(newNode);
newNode = xmlDoc.createElement("日期");
DateNode = xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("StartDate");
newNode.text = StartDate;
DateNode.appendChild(newNode);
newNode = xmlDoc.createElement("EndDate");
newNode.text = EndDate;
DateNode.appendChild(newNode);
newNode = xmlDoc.createElement("數量");
SLNode = xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("StartSL");
newNode.text = StartShuL;
SLNode.appendChild(newNode);
newNode = xmlDoc.createElement("EndSL");
newNode.text = EndShuL;
SLNode.appendChild(newNode);
newNode = xmlDoc.createElement("單價");
DJNode = xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("StartDJ");
newNode.text = StartDanJ;
DJNode.appendChild(newNode);
newNode = xmlDoc.createElement("EndDJ");
newNode.text = EndDanJ;
DJNode.appendChild(newNode);
newNode = xmlDoc.createElement("金額");
JENode = xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("StartJE");
newNode.text = StartJinE;
JENode.appendChild(newNode);
newNode = xmlDoc.createElement("EndJE");
newNode.text = EndJinE;
JENode.appendChild(newNode);
// 其餘單層節點直接掛到根節點即可
newNode = xmlDoc.createElement("倉庫代碼");
newNode.text = CK;
xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("票號");
newNode.text = RKPH;
xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("單位代碼");
newNode.text = CorpName;
xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("BiaoShi");
newNode.text = Biaoshi;
xmlDoc.documentElement.appendChild(newNode);
newNode = xmlDoc.createElement("FindCate");
newNode.text = FindCate;
xmlDoc.documentElement.appendChild(newNode);
// 送出
var xh = new ActiveXObject("MSXML2.XMLHTTP");
xh.open("POST", "Find.ASP", false);
xh.setRequestHeader("Content-Type", "text/XML");
xh.setRequestHeader("Content-Type", "gb2312");
xh.send(xmlDoc);
範例中每個 newNode 的 text 值都是變數,實際上就是客戶端表單裡各 input 欄位的值。
第一,示範中連續呼叫了兩次 setRequestHeader("Content-Type", ...),但標頭名稱相同時後者會覆蓋前者。正確做法是一次設定包含編碼的完整值,例如 "text/xml; charset=gb2312",否則編碼資訊實際上並未送出。
第二,組裝節點這段程式有明显的重複模式,實務上建議抽成一個輔助函式(傳入父節點、名稱與值),程式碼量能少掉一大半,可讀性也更好。另外別忘了伺服器端接收時要指定相同的編碼,兩邊對不上的話中文很容易變成亂碼——這是本類整合最常遇到的問題。