DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
動手做 AJAX:從讀取遠端 XML 到串接資料庫的完整入門
編輯:AJAX詳解     

過去 Web 應用程式的發展被一個事實限制著:想拿到新資料,就得重新載入整個頁面。雖然有 iframe 之類的替代做法,但它們支援度不佳、bug 也不少。AJAX 改變了這件事,讓開發者能用 JavaScript 非同步取得 XML 資料,在不重載頁面的前提下更新畫面。

本文是一份分階段的實作教程,從最簡單的讀取開始,一路做到與伺服器端資料庫整合。

第一階段:讀取遠端 XML 並更新頁面

準備資料

先建立一個名為 data.xml 的檔案。真實專案裡它會複雜得多,但入門階段越簡單越好:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <data>這是一些示例數據,它被保存在一個 XML 文件中,並被 JavaScript 取回。</data>
</root>

建立頁面骨架

這個頁面將承載我們的腳本,並讓使用者看到 AJAX 的實際效果。關鍵在於:我們在段落中預先放了一段預設文字,並附上一個直接連到 data.xml 的普通連結。

<p id="xmlObj">
  這是一些示例數據,它是這個網頁的默認數據
  <a href="data.xml" title="查看這個 XML 數據">查看 XML 數據.</a>
</p>

這個安排是有意的:對停用 JavaScript 的使用者,連結依然可用;對允許執行 JavaScript 的使用者,AJaxRead 函式會把內容替換掉,連結也就不會被用到。這正是前面文章談到的優雅降級,在最小的範例裡就該養成習慣。

核心函式

把這段腳本放進 head 標籤:

<script type="text/javascript"><!--
function AjaxRead(file) {
    var xmlObj = null;
    if (window.XMLHttpRequest) {
        xmlObj = new XMLHttpRequest();
    } else if (window.ActiveXObject) {
        xmlObj = new ActiveXObject("Microsoft.XMLHTTP");
    } else {
        return;
    }

    xmlObj.onreadystatechange = function() {
        if (xmlObj.readyState == 4) {
            updateObj('xmlObj',
                xmlObj.responseXML.getElementsByTagName('data')[0].firstChild.data);
        }
    };

    xmlObj.open('GET', file, true);
    xmlObj.send('');
}

function updateObj(obj, data) {
    document.getElementById(obj).firstChild.data = data;
}
//--></script>

逐段拆解:

1. 跨瀏覽器建立物件。標準瀏覽器有 window.XMLHttpRequest,舊版 IE 只有 ActiveX 版本。如果兩者都不存在,直接 return 結束函式,避免拋出腳本錯誤。這段程式能在 IE 5.01 以上運作,但在 Netscape 4 上會終止。

2. readyState 的五個狀態。每次 XMLHttpRequest 狀態改變,onreadystatechange 就會觸發:

  • 0 — 尚未初始化(請求開始前)
  • 1 — 載入中(初始化完成)
  • 2 — 載入完成(已從伺服器取得回應)
  • 3 — 互動中(正在與伺服器連線溝通)
  • 4 — 完成(所有工作結束)

只有狀態 4 才代表資料真正可用,所以我們檢驗 readyState == 4。實務上通常還會一併檢查 HTTP 狀態碼是否為 200,因為伺服器也可能回傳 404 或 500。

3. 從回應中取出資料。xmlObj.responseXML 是一個 DOM 物件,行為與 document 幾乎相同,只是來源是遠端 XML 檔。因此可以用 getElementsByTagName 取得節點。資料包在 <data> 裡,所以 getElementsByTagName("data")[0] 就取到了那個節點。

注意它回傳的是節點而非節點內容,還要再往下一層:firstChild 指向被 <data> 包住的文字節點,而 .data 才是實際文字。

4. open 與 send。open('GET', file, true) 開啟一個以 GET 方法向指定檔案發出的連接,第三個參數 true 表示非同步(預設值,也是 AJAX 之所以為 A 的原因)。send('') 送出一個空字串——少了這行,readyState 永遠不會走到 4,頁面也就永遠不會更新。

5. updateObj。它用新值更新頁面上任一指定元素,做法與取資料時類似:定位元素,把它的第一個子節點(文字節點)的 data 屬性設為新值。如果你想塞入 HTML 而非純文字,可以改用 document.getElementById(obj).innerHtml = data。

第二階段:處理成組的 XML 資料

設計 XML 結構

這次我們準備一組寵物清單:

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <pets>
    <pet>貓</pet>
    <pet>狗</pet>
    <pet>魚</pet>
  </pets>
</data>

結構層次清楚:XML 宣告 → 根元素 <data> → 群組元素 <pets> → 個別的 <pet> 節點,每個 pet 的文字節點是動物名稱。

改寫回呼

這次不再用 updateObj,改用一個專門處理 XML 的函式:

XMLObj.onreadystatechange = function() {
    if (XMLObj.readyState == 4) {
        processXML(xmlObj.responseXML);
    }
};

function processXML(obj) {
    var dataArray    = obj.getElementsByTagName('pet');
    var dataArrayLen = dataArray.length;
    var insertData   = '<table style="width:150px; border:solid 1px #000">'
                     + '<tr><th>Pets</th></tr>';

    for (var i = 0; i < dataArrayLen; i++) {
        insertData += '<tr><td>' + dataArray[i].firstChild.data + '</td></tr>';
    }
    insertData += '</table>';

    document.getElementById('dataArea').innerHtml = insertData;
}

邏輯是:先取得所有 <pet> 節點的集合與長度,然後逐一遍歷,每次組出一個表格列塞進 insertData,最後加上結尾標籤,用 innerHtml 一次寫進名為 dataArea 的 div。

三種等價的寫法,各有取捨

寫法 A:用不同標籤名——把每隻寵物做成獨立標籤(<貓 />、<狗 />、<魚 />),然後遍歷 <pets> 的子節點,直接讀 tagName。因為節點之間的空白也算文字節點,必須用 if (dataArray[i].tagName) 過濾掉。

寫法 B:用屬性——<pet type="貓" />,再用 getAttribute('type') 取值。這種寫法讓 processXML 最簡潔。

寫法 C:混合——標籤名承載寵物種類,屬性承載其他欄位,例如 <貓 tasks="喂食, 飲水, 抓跳蚤" />。這通常最易讀。

三者效能差異不大,但維護性差很多。以寫法 C 為例,如果哪天貓的跳蚤終於抓完了,你只要把 XML 裡那項任務刪掉就好;而在純子節點的結構中做同樣的修改,得動到 JavaScript 的迴圈邏輯。

處理子群組

若每隻寵物都有多項任務,就把任務放進子元素:

<pet>Cat
  <task>Feed</task>
  <task>Water</task>
  <task>Comb out fleas</task>
</pet>

processXML 需要多一層迴圈,並多兩個變數 subAry 與 subAryLen 指向當前 pet 的 task 集合。組字串時要注意逗號:只在「還有下一項」時才加上分隔符,用 if (subAryLen != j + 1) 判斷,避免尾端多一個逗號。

如果改用屬性寫法,整個函式會短很多:

<pet type="Cat" tasks="Feed, Water, Comb out fleas" />
for (var i = 0; i < dataArrayLen; i++) {
    insertData += '<tr><td>' + dataArray[i].getAttribute('type')  + '</td>'
                + '<td>' + dataArray[i].getAttribute('tasks') + '</td></tr>';
}

代碼變簡單,效率也跟著變好——因為省掉了內層迴圈與字串判斷。

第三階段:讓 PHP 從資料庫輸出 XML

現在把資料來源從靜態檔案換成資料庫。頁面幾乎不用改,只把 AjaxRead() 的參數從 data.xml 換成 data.php。

先確認資料庫連線

<?php
$user = "admin";
$pass = "adminpass";
$host = "localhost";
$conn = mysql_connect($host, $user, $pass) or die("無法連接 MySQL.");
$db   = mysql_select_db("pets", $conn) or die("無法選擇資料庫.");

$result = mysql_query("SELECT * FROM `pets`");
if (mysql_num_rows($result) == 0) {
    die('Error: 資料庫沒有資料.');
}
while ($row = mysql_fetch_assoc($result)) {
    echo 'Pet: ' . $row['pet'] . ', tasks: ' . $row['tasks'] . '. ';
}
mysql_close($db);
?>

改成輸出 XML

<?php
header('Content-Type: text/xml');                       // (1) 宣告輸出型別
echo '<?xml version="1.0" encoding="UTF-8"?>';         // (2) XML 宣告
echo "\n<data>\n<pets>\n";                            // (3) 開頭標籤

$user = "admin"; $pass = "adminpass"; $host = "localhost";
$conn = mysql_connect($host, $user, $pass) or die("無法連接 MySQL.");
$db   = mysql_select_db("pets", $conn) or die("無法選擇資料庫.");

$result = mysql_query("SELECT * FROM `pets`");
if (mysql_num_rows($result) == 0) { die('Error: 資料庫沒有資料.'); }

while ($row = mysql_fetch_assoc($result)) {
    echo '<' . $row['pet'] . ' tasks="' . $row['tasks'] . '" />' . "\n";   // (4)
}
echo "</pets>\n</data>";                            // (5) 收尾標籤
mysql_close($db);
?>

逐行說明:

  1. 送出 HTTP 標頭,讓客戶端知道這是 XML。這也是為什麼副檔名是 .php,瀏覽器卻當它是 XML 顯示。
  2. 輸出 XML 宣告,就是檔案第一行。
  3. 輸出根標籤 <data> 與群組標籤 <pets>。
  4. 迴圈遍歷資料庫結果,每次輸出一個節點:以寵物名稱作為標籤名,任務作為 tasks 屬性。尾端的 \n 只是換行,讓整份 XML 不要擠在同一行。
  5. 關閉前面開啟的兩個標籤。XML 必須格式良好(well-formed),這一步不能馬虎。

完成後,你就可以直接在資料庫中修改資料來更新畫面,而不必手動編輯 XML 檔——而且頁面依然不重新整理。

幾個實務上的注意事項

XML 必須格式良好。最常見的錯誤就是忘記關閉標籤。瀏覽器對 HTML 很寬容,對 XML 則完全不寬容,一個未閉合的標籤就會讓 responseXML 解析失敗。

標籤名有命名限制。用資料庫欄位值直接當 XML 標籤名(如範例中的 <貓>)聽起來方便,但實際專案裡資料值可能包含空白、數字開頭或其他不合法字元,就會產生無效 XML。更穩健的做法是固定標籤名、把變動值放在屬性或文字節點中。

務必做輸出轉義。範例把 $row['tasks'] 直接插進屬性值,如果內容含有引號或 &、< 等字元,就會破壞 XML 結構;若資料來源不可信,這還會形成注入風險。正式環境請一律用轉義函式處理。

檢查 HTTP 狀態碼。只判斷 readyState == 4 是不夠的,伺服器錯誤頁也會讓狀態變成 4。加上 xmlObj.status == 200 的判斷,除錯會輕鬆很多。

結語

整個 AJAX 的核心概念其實很單純:從某處讀一個檔案,不必重載頁面就能更新內容。而 XML 是「可擴充的」,代表組裝資料沒有唯一正解——但通常存在一個「比較好」的答案,而判斷標準是維護成本,不是程式碼長度。

再往前一步,你還可以用 PHP 動態產生 XML 檔案、讓 JavaScript 去讀,並定時檢查 XML 是否已變動、若有更新就刷新頁面。這正是 Gmail 與 Google Maps 這類應用的基礎構成——它們的實作當然複雜得多,但地基就是這些。

(註:本文範例使用 mysql_* 系列函式,該擴充已在 PHP 7 中移除。若要在現代環境實作,請改用 PDO 或 MySQLi,並一律採用參數化查詢。)

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