DIV CSS 佈局教程網

AJAXRequest v0.2:用建構子參數簡化呼叫流程
編輯:AJAX基礎知識     

本次更新的重點只有一個:讓建構子接受參數,把原本「先 new、再逐一指定屬性」的三步驟濃縮成一行。

類別規格

類別名稱:AJAXRequest

建立方式:

var ajaxobj = new AJAXRequest(method, url, async, content, callback);

若建立失敗則回傳 false。

屬性

  • method:請求方法,字串,POST 或 GET,預設 POST。
  • url:請求 URL,字串,預設空。
  • async:是否非同步,true 為非同步、false 為同步,預設 true。
  • content:請求內容,POST 時需設定,預設空。
  • callback:回呼函式,收到回應時呼叫,預設直接回傳。函式有一個參數,即 XMLHttpRequest 物件,寫成 function mycallback(xmlobj)。

方法

send():送出請求,無參數。

使用範例

<script type="text/javascript" src="ajaxrequest.js"></script>
<script type="text/javascript">
// 請求方式 GET,URL 為 default.asp,非同步
var ajaxobj = new AJAXRequest("GET", "default.asp", true, null, MyCallback);
ajaxobj.send();

function MyCallback(xmlObj) {
    document.write(xmlObj.responseText);
}
</script>

ajaxrequest.js

/*------------------------------------------
Author: xujiwei
Website: https://www.xujiwei.cn
E-mail: vipxjw@163.com
Copyright (c) 2006, All Rights Reserved
------------------------------------------*/
function AJAXRequest(pmethod, purl, pasync, pcontent, pcallback) {
    var xmlObj = false;
    var CBfunc, ObjSelf;
    ObjSelf = this;

    try { xmlObj = new XMLHttpRequest; }
    catch (e) {
        try { xmlObj = new ActiveXObject("MSXML2.XMLHTTP"); }
        catch (e2) {
            try { xmlObj = new ActiveXObject("Microsoft.XMLHTTP"); }
            catch (e3) { xmlObj = false; }
        }
    }

    if (!xmlObj) return false;

    this.method = pmethod;
    this.url = purl;
    this.async = pasync;
    this.content = pcontent;
    this.callback = pcallback;

    this.send = function () {
        if (!this.method || !this.url || !this.async) return false;

        xmlObj.open(this.method, this.url, this.async);
        if (this.method == "POST")
            xmlObj.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

        xmlObj.onreadystatechange = function () {
            if (xmlObj.readyState == 4) {
                if (xmlObj.status == 200) {
                    ObjSelf.callback(xmlObj);
                }
            }
        }

        if (this.method == "POST") xmlObj.send(this.content);
        else xmlObj.send(null);
    }
}

從 0.1 到 0.2 的取捨

把參數拉進建構子,讓呼叫端一眼就能看出這次請求的完整意圖,也省下四次屬性賦值。代價是參數順序必須記牢,特別是 content 與 callback 的位置。若要進一步改善可讀性,可以考慮改用 options 物件傳参,例如 new AJAXRequest({url: "...", method: "GET", callback: fn}),這樣就不必在意順序,也能自然省略不需要的欄位。

另外,範例中的 MyCallback 印的是 xmlobj.responseText,但函式參數名為 xmlObj,實際執行會出現未定義變數的錯誤,這裡應統一命名。

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