DIV CSS 佈局教程網

用 AJAXRequest 開發 Ajax 應用(一):從 Hello, World! 開始
編輯:AJAX基礎知識     

AJAXRequest 類別發表了幾個版本之後,陸續有朋友開始使用,也常有人問有沒有更詳細的說明與範例。因為時間有限、能想到的範例也不多,一直沒能多寫幾個。考量之後,決定寫成一個系列教程,希望對使用這個類別的人有幫助。

準備工作

需要的知識:JavaScript 基本語法、DOM(文件物件模型)相關知識,以及至少熟悉一種後端語言(本文範例以 ASP 撰寫)。

需要的工具:EditPlus 或其他文字編輯器(Dreamweaver、Visual Web Developer 亦可),以及一個本機測試用的 Web 伺服器(IIS、Apache 或 NetBox 等)。AJAXRequest 類別可在 https://www.xujiwei.cn/works/ajaxrequest/ 下載。

為什麼要在本機架測試伺服器,而不是直接用瀏覽器開檔?因為從一開始就在接近真實的環境中開發,後續能少掉一堆莫名的錯誤——尤其是本機 file:// 協定下的跨來源限制會讓 Ajax 直接失效。

本系列會把 JS 程式碼與 XHTML 分開撰寫,ajaxrequest.js 放在範例同一目錄下。

Hello, World!

helloworld.htm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
  <head>
    <meta name="author" content="xujiwei" />
    <title>Hello, World!</title>
    <!-- 引入 AJAXRequest 類別檔 -->
    <script type="text/javascript" src="ajaxrequest.js"></script>
    <!-- 引入本頁需要的 JS -->
    <script type="text/javascript" src="helloworld.js"></script>
  </head>
  <body>
    <!-- 點擊後呼叫 showHello,顯示從伺服器取得的訊息 -->
    <button onclick="showHello();">顯示 Hello, World!</button>
  </body>
</html>

helloworld.js

// 以全域變數保存 AJAXRequest 物件,
// 整個頁面應用程式只需建立一次,不必重複 new。
var ajax = new AJAXRequest();

// showHello:向伺服器發出請求並顯示返回資訊
function showHello() {
    // 用 get 方法取得 helloworld.txt 的內容,並在 mycallback 中處理
    ajax.get("helloworld.txt", mycallback);
}

// mycallback:處理伺服器回應
// 參數 obj 為 XMLHttpRequest 物件,保存伺服器返回的資訊
function mycallback(obj) {
    // obj.responseText 即為 helloworld.txt 的內容
    alert(obj.responseText);
}

helloworld.txt

Hello, World!

為什麼要用全域變數?

把 ajax 宣告成全域,多個函式要發請求時就直接沿用同一個物件,不必每處都 new 一次。這是因為 AJAXRequest 類別內部具有連接池特性,不會出現「網路延遲大時後來的請求覆蓋前面的請求」這種情況——這也是自製封裝最容易忽略的一點:把多個請求塞進同一個全域 XMLHTTP 變數,回呼就會互相踩到。

小結

這裡寫了一個很小的 Ajax 應用程式:用 AJAXRequest 類別從伺服器取回一個文字檔並顯示內容。整個過程中只用到 get 方法,就完成了從伺服器取得檔案的工作。

若改用今天的原生寫法,同樣的事情會是:

fetch("helloworld.txt")
    .then(response => response.text())
    .then(text => alert(text));

對照之下更能看出 AJAXRequest 當年的價值:它把「建立物件、判斷狀態、處理錯誤」這些樣板收進類別,讓呼叫端只剩一行語意明確的敘述——而 Promise 與 async/await 出現之後,這個樣板才終於從語言層級被解決。

下一篇將繼續說明 AJAXRequest 的其他用法。

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