這個異步請求類(作者:吾非無心,2009 年 2 月建立)有兩個不太常見的設計:一是遇到外部網址時自動改走本站代理頁以解決跨域問題,二是以佇列方式讓同一時間只有一個請求在跑,避免狀態互相干擾。
2009 年 4 月 27 日加入了 URL 檢測功能:若判定為 https://xxxx.xxx.xx.xx/... 這種外部網址,就改用系統提供的 /getUrl.aspx 代為抓取。getUrl.aspx 有兩個主要參數:url 為目標網址(可帶參數,必填);method 為代理使用的方法(可選),若為空則預設以 POST 代理,若 FORM 參數為空(即 content-length 為 0)則自動改為 GET。該代理頁在同一天重新設計,於原本的代理功能之外新增了 Cookie 代理。
function IsOuterURL(str_url){
var strRegex = "((https|http)://)([\\w-]+\\.)+[\\w-]+.([^a-z])(/[\\w-./?%&=]*)?|((https|http)://)[a-zA-Z0-9\\-\\.][\\w-]+.([^a-z])(/[\\w-./?%&=]*)?";
return new RegExp(strRegex).test(str_url);
}
var LeesAjaxRequest = {
list: [], // 等待中的請求佇列
m_LeesAjaxHttpRequest: null,
isWorking: false, // 是否已有請求在進行
getUrl: function(method, url, params, successFun, FailureFun, headers) {
if (url.length < 1) return;
if (this.m_LeesAjaxHttpRequest == null) {
if (typeof XMLHttpRequest != 'undefined') {
this.m_LeesAjaxHttpRequest = new XMLHttpRequest();
} else if (typeof ActiveXObject != 'undefined') {
this.m_LeesAjaxHttpRequest = new ActiveXObject('Microsoft.XMLHTTP');
}
}
if (!this.m_LeesAjaxHttpRequest) return;
if (this.isWorking) { // 忙碌中,先排入佇列
this.list[this.list.length] = {
method: method, url: url, params: params,
successFun: successFun, failureFun: FailureFun, headers: headers
};
return;
}
this.isWorking = true;
if (IsOuterURL(url)) // 外部網址走代理,解決跨域
this.m_LeesAjaxHttpRequest.open(method,
"/geturl.aspx?url=" + escape(url) + "&method=" + method, true);
else
this.m_LeesAjaxHttpRequest.open(method, url, true);
var _this = this;
this.m_LeesAjaxHttpRequest.onreadystatechange = function() {
if (4 == _this.m_LeesAjaxHttpRequest.readyState) {
if (200 == _this.m_LeesAjaxHttpRequest.status) {
if (successFun) { try { successFun(_this.m_LeesAjaxHttpRequest); } catch (ex) {} }
} else {
if (FailureFun) { try { FailureFun(_this.m_LeesAjaxHttpRequest); } catch (ex) {} }
}
_this.isWorking = false;
if (_this.list.length > 0) { // 取出下一個繼續執行
var o = _this.list[0];
_this.list.splice(0, 1);
_this.getUrl(o.method, o.url, o.params, o.successFun, o.failureFun, o.headers);
}
}
};
var vPara = "";
if (typeof params == "string") {
vPara = escape(params);
} else if (params) {
try {
for (var e in params) {
vPara += (vPara.length < 1 ? "" : "&") + e + "=" + escape(params[e]);
}
} catch (ex) {}
}
if (headers) {
try {
for (var h in headers) {
this.m_LeesAjaxHttpRequest.setRequestHeader(h.replace("_", "-"), headers[h]);
}
} catch (ex) {}
}
this.m_LeesAjaxHttpRequest.send(vPara);
},
Post: function(o) {
this.getUrl(o.method || "post", o.url, o.params || "",
o.success, o.failure, o.headers);
},
Get: function(o) {
this.getUrl(o.method || "get", o.url, o.params || "",
o.success, o.failure, o.headers);
}
};
動態載入外部 JS 檔。把 Content_Type 寫成 Content-Type(類別用底線分隔,內部會自動替換),回來後直接建一個 script 標籤塞進文件樹:
if (vJS && vJS.length > 3) {
if (!_this.loadedJS.isInArray(vJS)) {
_this.loadedJS[_this.loadedJS.length] = vJS;
LeesAjaxRequest.Get({
url: vJS,
success: function(ojs){
var jsOBJ = document.createElement("script");
jsOBJ.text = ojs.responseText;
document.documentElement.appendChild(jsOBJ);
},
headers: { Content_Type: "application/x-javascript" }
});
}
}
產生工具提示。用 POST 取回提示內容,再依回傳的寬高與圖片組出一個浮動小窗,滑入滑出時切換背景位置做出圖示動畫:
LeesAjaxRequest.Post({
url: "/getToolTip.aspx",
params: { tooltip: title },
headers: { Content_Type: "application/x-www-form-urlencoded;charset=utf-8" },
success: function(o){
var rObj = eval("(" + o.responseText + ")");
var tObj = new LeesBaseWindow(rObj["width"] + 2, rObj["height"] + 1,
"", "", "", "", "", 1, "");
tObj.ShowWindow(vToolBarSlider.window);
tObj.contentWindow.style.backgroundImage = "url(" + rObj["image"] + ")";
tObj.contentWindow.onmouseover = function(){
this.style.backgroundPosition = "0 -" + rObj.height;
_this.setShowWindow(obj);
};
tObj.contentWindow.onmouseout = function(){ this.style.backgroundPosition = "0 0"; };
},
failure: function(){ alert("生成 ToolTip 時出錯"); }
});
這個佇列機制等於放棄了並行請求:所有請求被序列化,好處是不必操心回應順序與狀態覆寫,代價是整體吞吐下降。若頁面有多個互不相關的請求,序列化會讓總等待時間相加。此外,範例中的 eval("(" + ... + ")") 建議改用 JSON.parse;跨域代理頁也必須做好目標網址白名單,否則容易成為開放代理而被濫用。