DIV CSS 佈局教程網

AJAX 開發實務(下):請求框架、DOM 操作與 XML 處理
編輯:AJAX基礎知識     

讀完上篇,我們已經清楚 AJAX 是什麼、能做什麼、極限在哪裡。如果你認為它真能改善手邊的開發工作,那麼接著看怎麼把它用起來。

7.1 涉及的四項關鍵技術

AJAX 涉及的技術中,我認為最實用的是 JavaScript、XMLHttpRequest、DOM 與 XML。

XMLHttpRequest 物件

它是 XMLHTTP 元件的物件化包裝。透過它,AJAX 能像桌面應用程式一樣只與伺服器做資料層的交換,不必每次刷新介面,也不必把所有處理都推給伺服器——既減輕負擔,又加快回應。

IE 5.0 起,開發者可在頁面內使用 XMLHTTP ActiveX 元件擴充功能,不必從當前頁面導航就能直接傳輸資料。Mozilla 1.0 與 Netscape 7 則是建立繼承自 XML 的代理類別 XMLHttpRequest。大多數情況下兩者方法與屬性類似,僅部分屬性不同。

<script language="javascript">
var http_request = false;
// IE 瀏覽器
http_request = new ActiveXObject("Msxml2.XMLHTTP");
http_request = new ActiveXObject("Microsoft.XMLHTTP");
// Mozilla 瀏覽器
http_request = new XMLHttpRequest();
</script>

方法:abort() 停止當前請求;getAllResponseHeaders() 以字串回傳完整標頭;getResponseHeader("headerLabel") 回傳單一標頭;open("method","URL"[,asyncFlag[,"userName"[, "password"]]]) 設定請求的目標、方法與其他參數;send(content) 送出請求;setRequestHeader("label","value") 設定並送出標頭。

屬性:onreadystatechange 為狀態改變的事件觸發器;readyState 表示物件狀態(0 未初始化、1 讀取中、2 已讀取、3 互動中、4 完成);responseText 為伺服器回應的文字版本;responseXML 為相容 DOM 的 XML 文件物件;status 為伺服器狀態碼(如 404 檔案未找到、200 成功);statusText 為狀態文字。

JavaScript

它長期被定位為客戶端腳本語言,最常見的用途是表單驗證。透過它操作 XMLHttpRequest,就能直接和資料庫打交道。

DOM

文件物件模型(Document Object Model)是提供給 HTML 與 XML 的一組 API,定義了文件的結構表示,並可藉此改變內容與可見性。腳本語言必須透過 DOM 才能與頁面互動。

XML

可擴充標記語言讓結構化資料有了統一標準,用它表示的資料與文件容易在不同程式間共享。

7.2 組出一個請求框架

AJAX 本質上仍遵循 Request/Response 模式,流程是:物件初始化 → 送出請求 → 伺服器接收 → 伺服器回應 → 客戶端接收 → 修改頁面內容,只不過整個過程是非同步的。

A、初始化並送出請求

為了跨瀏覽器運行,建立物件的寫法要分兩路:

if (window.XMLHttpRequest) {
    // Mozilla, Safari, ...
    http_request = new XMLHttpRequest();
} else if (window.ActiveXObject) {
    // IE
    http_request = new ActiveXObject("Microsoft.XMLHTTP");
}

部分 Mozilla 版本在處理伺服器回傳「未含 XML MIME 標頭」的內容時會出錯,因此要確保內容帶有 text/xml:

http_request = new XMLHttpRequest();
http_request.overrideMimeType('text/xml');

B、指定回應處理函式

把處理函式名稱賦給 onreadystatechange 即可。注意函式名稱不加括號、不帶參數:

http_request.onreadystatechange = processRequest;

也可以用即時定義的方式:

http_request.onreadystatechange = function () { };

C、送出 HTTP 請求

http_request.open('GET', 'https://www.example.org/some.file', true);
http_request.send(null);

open 的第一個參數是方法(GET、POST 或 HEAD);第二個參數是目標 URL,基於安全性考量只能是同網域,否則會出現「沒有權限」的錯誤,且這個 URL 可以是需要伺服器解釋執行的頁面,伺服器端如 JSP 可用 request.getParameter("") 取值;第三個參數決定等待回應期間是否繼續往下執行,預設為 True。

若以 POST 送出,且要傳檔案或表單內容,必須先設定 MIME 類型:

http_request.setRequestHeader("Content-Type","application/x-www-form-urlencoded");

此時資料以查詢字串形式作為 send 的參數,例如 name=value&anothername=othervalue&so=on。

D、處理伺服器回應

先檢查 readyState,等於 4 時代表資料已全部傳回:

if (http_request.readyState == 4) {
    // 資訊已返回,可以開始處理
} else {
    // 資訊還沒返回,等待
}

接著判斷 HTTP 狀態碼,200 代表頁面正常:

if (http_request.status == 200) {
    // 頁面正常,可以開始處理資訊
} else {
    // 頁面有問題
}

成功回應有兩種取用方式:responseText 把內容當字串,responseXML 把內容當 XML 文件並可用 DOM 處理。

E、初步框架

<script language="javascript">
var http_request = false;

function send_request(url) {
    http_request = false;
    if (window.XMLHttpRequest) {
        http_request = new XMLHttpRequest();
        if (http_request.overrideMimeType) {
            http_request.overrideMimeType("text/xml");
        }
    } else if (window.ActiveXObject) {
        try {
            http_request = new ActiveXObject("Msxml2.XMLHTTP");
        } catch (e) {
            try {
                http_request = new ActiveXObject("Microsoft.XMLHTTP");
            } catch (e) { }
        }
    }

    if (!http_request) {
        window.alert("不能建立 XMLHttpRequest 物件執行個體.");
        return false;
    }

    http_request.onreadystatechange = processRequest;
    http_request.open("GET", url, true);
    http_request.send(null);
}

function processRequest() {
    if (http_request.readyState == 4) {
        if (http_request.status == 200) {
            alert(http_request.responseText);
        } else {
            alert("您所請求的頁面有異常。");
        }
    }
}
</script>

7.3 兩個簡單示例

A、資料驗證

表單中加一段用戶名唯一性檢查,按下按鈕時以非同步方式送出,用 alert 顯示結果,不必開新視窗:

<form name="form1" action="" method="post">
 用戶名:<input type="text" name="username" value="">&nbsp;
 <input type="button" name="check" value="唯一性檢查" onClick="userCheck()">
 <input type="submit" name="submit" value="提交">
</form>

function userCheck() {
    var f = document.form1;
    var username = f.username.value;
    if (username == "") {
        window.alert("用戶名不能為空。");
        f.username.focus();
        return false;
    } else {
        send_request('sample1_2.jsp?username=' + username);
    }
}

伺服器端只需把判斷結果印出來:

<%@ page contentType="text/html; charset=gb2312" errorPage="" %>
<%
String username = request.getParameter("username");
if ("educhina".equals(username)) out.print("用戶名已經被注冊,請更換一個用戶名。");
else out.print("用戶名尚未被使用,您可以繼續。");
%>

執行起來沒有彈窗、沒有頁面刷新,與預期一致。


B、串接選單

先擺好 HTML 骨架,用 display:none 隱藏子區塊:

<table width="200" border="0" cellspacing="0" cellpadding="0">
 <tr> <td height="20"> <a href="javascript:void(0)" onClick="showRoles('pos_1')">經理室</a> </td> </tr>
 <tr style="display:none"> <td height="20" id="pos_1">&nbsp;</td> </tr>
 <tr> <td height="20"> <a href="javascript:void(0)" onClick="showRoles('pos_2')">開發部</a> </td> </tr>
 <tr style="display:none "> <td id="pos_2" height="20">&nbsp;</td> </tr>
</table>

點擊時先展開該列並顯示提示,再送出請求:

// 顯示部門下的崗位
function showRoles(obj) {
    document.getElementById(obj).parentNode.style.display = "";
    document.getElementById(obj).innerHTML = "正在讀取數據..."
    currentPos = obj;
    send_request("sample2_2.jsp?playPos=" + obj);
}

// 處理返回資訊的函式
function processRequest() {
    if (http_request.readyState == 4) {
        if (http_request.status == 200) {
            document.getElementById(currentPos).innerHTML = http_request.responseText;
        } else {
            alert("您所請求的頁面有異常。");
        }
    }
}

伺服器端依參數回傳對應的職位清單:

<%@ page contentType="text/html; charset=gb2312" errorPage="" %>
<%
String playPos = request.getParameter("playPos");
if ("pos_1".equals(playPos)) out.print("&nbsp;&nbsp;總經理<br>&nbsp;&nbsp;副總經理");
else if ("pos_2".equals(playPos)) out.println("&nbsp;&nbsp;總工程師<br>&nbsp;&nbsp;軟件工程師");
%>

7.4 文件物件模型(DOM)

DOM 是表示 HTML 與 XML 文件,並訪問、操作其元素的 API。本文所指的是 W3C 標準的 DOM,它以樹狀結構表示文件,定義了遍歷樹與檢查、修改節點的方法與屬性。

7.4.1 HTML 文件在 DOM 眼中的樣子

HTML 與 XML 一樣是樹狀結構:<html> 是根節點,<head>、<title>、<body> 是它的子節點,彼此互為兄弟節點;<body> 之下才是 <table>、<span>、<p> 等子節點。

與 XML 不同的是,HTML 的樹主要包含表示元素與標記的節點,以及表示文字串的節點。

7.4.2 節點類型

DOM 把各節點視為不同類型的 Node 物件,並以 nodeType 區分:

  • Element:Node.ELEMENT_NODE,值為 1
  • Attr:Node.ATTRIBUTE_NODE,值為 2
  • Text:Node.TEXT_NODE,值為 3
  • Comment:Node.COMMENT_NODE,值為 8
  • Document:Node.DOCUMENT_NODE,值為 9
  • DocumentFragment:Node.DOCUMENT_FRAGMENT_NODE,值為 11

樹的根節點是 Document 物件,其 documentElement 屬性參照根元素(HTML 文件中即 <html>)。JavaScript 操作時,document 指向整個文件,<body>、<table> 等即為 Element 類型,註解則是 Comment 類型。

Document 的常用方法:createAttribute()、createComment()、createElement()、createTextNode() 分別建立 Attr、Comment、Element、TextNode 節點;getElementById() 回傳具有指定 id 的元素;getElementsByTagName() 回傳具有指定標記名的所有元素。

Element 的常用屬性與方法:tagName 回傳標記名稱(HTML 中均為大寫);getAttribute()、setAttribute()、removeAttribute() 用於查詢、設定、刪除屬性;getAttributeNode()、setAttributeNode()、removeAttributeNode() 則以 Attr 節點為單位操作;hasAttribute() 判斷屬性是否存在;getElementsByTagName() 回傳子孫節點集合。

Attr 物件代表元素屬性,有 name、value 等屬性,可透過 Node 的 attributes 或 Element 的 getAttributeNode() 取得。不過實務上直接用 getAttribute() 與 setAttribute() 最簡單。

7.4.3 遍歷與修改文件

用 parentNode 與 childNodes[] 可在樹中上下移動;用 firstChild/nextSibling 正向走訪,或用 lastChild/previousSibling 逆向走訪;appendChild()、insertBefore()、removeChild()、replaceChild() 則可改變子節點結構。

要留意 childNodes[] 實際上是 NodeList 物件,可以搭配遞迴枚舉整棵樹的所有節點。

Node 常用屬性:attributes(Element 的屬性集合,NamedNodeMap)、childNodes(子節點陣列)、firstChild、lastChild、nextSibling、previousSibling、nodeName、nodeType、parentNode。

Node 常用方法:appendChild() 增加子節點;cloneNode() 複製節點(可含子孫);hasChildNodes() 判斷是否有子節點;insertBefore() 在指定子節點前插入;removeChild() 刪除並回傳子節點;replaceChild() 以另一節點取代。

例子 1:用 childNodes[] 遞迴統計元素

使用 DOM 時必須等文件載入完畢再操作。這個例子統計文件中 Element 的總數並印出標記名:

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>無標題文檔</title>
<script language="javascript">
var elementName = "";   // 全域變數,保存 Element 標記名,用完要清空

function countTotalElement(node) {
    var total = 0;
    if (node.nodeType == 1) {          // 檢查是否為 Element
        total++;                        // 是則計數器加一
        elementName = elementName + node.tagName + "\r\n";
    }
    var childrens = node.childNodes;    // 取得全部子節點
    for (var i = 0; i < childrens.length; i++) {
        total += countTotalElement(childrens[i]);   // 遞迴
    }
    return total;
}
</script>
</head>
<body>
<a href="javascript:void(0)" onClick="alert('標記總數:' + countTotalElement(document)
    + '\r\n<br><br>全部標記如下:\r\n' + elementName); elementName='';">開始統計</a>
</body>
</html>

例子 2:改用 firstChild 與 nextSibling 走訪

其他部分不變,只替換 countTotalElement 的迴圈:

function countTotalElement(node) {
    var total = 0;
    if (node.nodeType == 1) {
        total++;
        elementName = elementName + node.tagName + "\r\n";
    }
    for (var m = node.firstChild; m != null; m = m.nextSibling) {
        total += countTotalElement(m);
    }
    return total;
}

搜尋特定元素

document.getElementsByTagName() 回傳具有指定標記名的全部元素,順序即文件中出現的順序,參數忽略大小寫。想定位第一個 <table> 可寫成 document.getElementsByTagName("table")[0];例外是 document.body,因為它是唯一的。

getElementsByTagName() 的回傳結果會隨文件變動而即時改變;getElementById() 則較為靈活,只要目標元素有唯一的 id 即可隨時定位。Element 物件也支援這兩個方法,但搜尋範圍僅限於自己的子節點。

例子 3:顛倒節點順序

用 removeChild() 搭配 appendChild() 逆向重排子節點:

function reverseNode(node) {
    var kids = node.childNodes;
    var kidsNum = kids.length;
    for (var i = kidsNum - 1; i >= 0; i--) {
        var c = node.removeChild(kids[i]);   // 刪除指定子節點並保存
        node.appendChild(c);                 // 放到新位置
    }
}
// 呼叫:reverseNode(document.body)

例子 4:顛倒表格列

若未使用 <tbody> 標籤,瀏覽器會把所有 <tr> 視為同一個 <tbody> 的子節點,因此改用陣列暫存每列內容再重建:

function reverseTable() {
    var node = document.getElementsByTagName("table")[0];
    var child = node.getElementsByTagName("tr");
    var newChild = new Array();
    for (var i = 0; i < child.length; i++) {
        newChild[i] = child[i].firstChild.innerHTML;
    }
    node.removeChild(node.childNodes[0]);      // 刪除全部單元列
    var header = node.createTHead();           // 新建表頭
    for (var i = 0; i < newChild.length; i++) {
        var headerrow = header.insertRow(i);   // 插入一列
        var cell = headerrow.insertCell(0);    // 插入一格
        cell.appendChild(document.createTextNode(newChild[newChild.length - i - 1]));
    }
}

例子 5:替換兩個表格的內容

function replaceContent() {
    var table1 = document.getElementsByTagName("table")[0];
    var table2 = document.getElementsByTagName("table")[1];
    var kid1 = table1.firstChild.firstChild.firstChild;   // 定位到 <td>
    var kid2 = table2.firstChild.firstChild.firstChild;
    var repKid = kid2.firstChild;                         // 定位到表格二的 TextNode
    try {
        // 用表格二的單元格內容替換表格一
        kid1.replaceChild(repKid, kid1.firstChild);
        // 以下若開放將出現 object error,因為表格二已被改變
        // kid2.replaceChild(kid1.firstChild, kid2.firstChild);
    } catch (e) { alert(e); }
}

這裡有個容易踩的陷阱:執行 kid1.replaceChild(repKid, kid1.firstChild) 之後,table2 的子節點已被移轉到 table1,table2 不再擁有子節點,因此不能再次呼叫它的子節點。實際跑一遍就能看出文件結構如何改變。

例子 6:往文件加入新內容——一個簡易留言簿

因為 <table> 的子節點是 <tbody>,<tbody> 的子節點才是 <tr>,<tr> 之下是 <td>,最內層才是 TextNode,所以要新增一列必須逐層組裝:

function insertStr() {
    var f = document.form1;
    var value = f.str.value;
    if (value != "") {
        var text = document.createTextNode(value);   // 文字節點
        var td = document.createElement("td");       // td 元素
        var tr = document.createElement("tr");       // tr 元素
        var tbody = document.createElement("tbody"); // tbody 元素
        td.appendChild(text);
        tr.appendChild(td);
        tbody.appendChild(tr);

        var parNode = document.getElementById("table1");
        parNode.insertBefore(tbody, parNode.firstChild);   // 插到頂部
        // parNode.appendChild(tbody);                     // 或加到尾端
    }
}

對應的 HTML 骨架含一個輸入框、一個留言按鈕,以及 id 為 table1 的表格。就像往樹上接枝一樣,要有葉子也要有枝徑,逐層 appendChild 即可。


例子 7:用 DOM 操作 XML 文件

處理 XML 的典型流程是「載入 → 提取資訊 → 加工 → 建立 HTML」。要注意文件載入並非瞬間完成,因此需傳入一個處理函式,等載入完成後再呼叫。

function loadXML(handler) {
    var url = "employees.xml";
    if (document.implementation && document.implementation.createDocument) {
        var xmldoc = document.implementation.createDocument("", "", null);
        xmldoc.onload = handler(xmldoc, url);
        xmldoc.load(url);
    } else if (window.ActiveXObject) {
        var xmldoc = new ActiveXObject("Microsoft.XMLDOM");
        xmldoc.onreadystatechange = function () {
            if (xmldoc.readyState == 4) handler(xmldoc, url);
        }
        xmldoc.load(url);
    }
}

function makeTable(xmldoc, url) {
    var table = document.createElement("table");
    table.setAttribute("border", "1");
    table.setAttribute("width", "600");
    table.setAttribute("class", "tab-content");
    document.body.appendChild(table);

    table.createCaption().appendChild(document.createTextNode("Employee Data from " + url));

    var header = table.createTHead();
    var headerrow = header.insertRow(0);
    headerrow.insertCell(0).appendChild(document.createTextNode("姓名"));
    headerrow.insertCell(1).appendChild(document.createTextNode("職業"));
    headerrow.insertCell(2).appendChild(document.createTextNode("工資"));

    var employees = xmldoc.getElementsByTagName("employee");
    for (var i = 0; i < employees.length; i++) {
        var e = employees[i];
        var name = e.getAttribute("name");
        var job = e.getElementsByTagName("job")[0].firstChild.data;
        var salary = e.getElementsByTagName("salary")[0].firstChild.data;
        var row = table.insertRow(i + 1);
        row.insertCell(0).appendChild(document.createTextNode(name));
        row.insertCell(1).appendChild(document.createTextNode(job));
        row.insertCell(2).appendChild(document.createTextNode(salary));
    }
}
// <body onLoad="loadXML(makeTable)">

對應的 XML 文件 employees.xml:

<?xml version="1.0" encoding="gb2312"?>
<employees>
  <employee name="J.Doe">
    <job>Programmer</job>
    <salary>32768</salary>
  </employee>
  <employee name="A.Baker">
    <job>Sales</job>
    <salary>70000</salary>
  </employee>
  <employee name="Big Cheese">
    <job>CEO</job>
    <salary>100000</salary>
  </employee>
</employees>

7.5 處理 XML 文件

脫離 XML 的 AJAX 是不完整的。但也別把 AJAX 做成 AJAH——XML 在結構化表示與系統對接上有先天優勢,並非所有資料都適合用 XML 表達。

7.5.1 讀取回傳的 XML

沿用前面的框架,只需在 body 放一顆按鈕並改寫 processRequest:

<input type="button" name="read" value="讀取XML" onClick="send_request('employees.xml')">

function processRequest() {
    if (http_request.readyState == 4) {
        if (http_request.status == 200) {
            var xmlobj = http_request.responseXML;
            var employees = xmlobj.getElementsByTagName("employee");
            var feedbackStr = "";
            for (var i = 0; i < employees.length; i++) {
                var employee = employees[i];
                feedbackStr += "員工:" + employee.getAttribute("name");
                feedbackStr += " 職位:" + employee.getElementsByTagName("job")[0].firstChild.data;
                feedbackStr += " 工資:" + employee.getElementsByTagName("salary")[0].firstChild.data;
                feedbackStr += "\r\n";
            }
            alert(feedbackStr);
        } else {
            alert("您所請求的頁面有異常。");
        }
    }
}

7.5.2 選擇合適的 XML 產生方式

現在的 Web 應用多採 MVC 分層設計,XML 通常由 JavaBean 動態轉換而來。以下兩種常見做法各有取捨。

A、類別自行序列化。每個類別實作自己的 toXML(),自行選擇合適的 API、XML 結構與產生邏輯。搭配 JDOM 這類現成 API 可以省下不少工夫:

public Element toXml() {
    Element employee = new Element("employee");
    employee.setAttribute("name", name);
    Element jobE = new Element("job").addContent(job);
    employee.setContent(jobE);
    Element salaryE = new Element("salary").addContent(salary);
    employee.setContent(salaryE);
    return employee;
}

外面再包一層 Document,用 XMLOutputter 寫入 servlet 即可。toXml() 也允許遞迴呼叫子類別的實作,產生含子圖的 XML。缺點是每個類別都得寫一份,而且資料模型與視圖耦合——要嘛為每種視圖各寫一份 toXML(),要嘛就接受冗餘資料;一旦資料結構改變,所有 toXML() 都得跟著改。

B、頁面模板產生 XML。用通用的模板技術產生 XML,可以符合任何需要的資料模型,供 AJAX 靈活調用,而且模板可用任何標記語言撰寫:

<%@ page contentType="application/xml; charset=gb2312" import="Employee"%>
<%@ page import="java.util.Collection,java.util.ArrayList"%>
<?xml version="1.0"?>
<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%>
<%
Employee em1 = new Employee();
em1.setName("J.Doe"); em1.setJob("Programmer"); em1.setSalary("32768");
Employee em2 = new Employee();
em2.setName("A.Baker"); em2.setJob("Sales"); em2.setSalary("70000");
Employee em3 = new Employee();
em3.setName("Big Cheese"); em3.setJob("CEO"); em3.setSalary("100000");
Collection employees = new ArrayList();
employees.add(em1); employees.add(em2); employees.add(em3);
pageContext.setAttribute("employees", employees);
%>
<employees>
<logic:iterate name="employees" id="employee">
  <employee name="<bean:write name='employee' property='name'/>">
    <job><bean:write name="employee" property="job"/></job>
    <salary><bean:write name="employee" property="salary"/></salary>
  </employee>
</logic:iterate>
</employees>

這種做法需要為每個資料模型準備一個對應的 JSP,但比較容易確保標記匹配、元素與屬性順序正確,以及 XML 實體正確轉義。

7.5.3 XML 還是純文字?

XML 的問題之一是延遲——伺服器需要時間把 XML 解析成 DOM 模型,這在一定程度上會影響 AJAX 要求的即時反應。何況有些情境根本不需要結構化格式,例如回應只是一個字串(如前面的資料驗證與串接選單範例)。

以下情況適合成為使用 XML 的理由:

  • 資料較複雜,需要結構化方式表達;
  • 頻寬與處理效率不是瓶頸;
  • 需與系統其他 API 或外部系統對接,作為資料中轉中介;
  • 需要特定格式的輸出視圖,而純文字無法勝任。

總之,要認真評估兩種表示方式的成本與效率,再挑選合適的方案。

參考資料

  • fanscial,《AJAX 簡介》
  • Amour GUO,《AJAX 內部交流文檔》
  • MoztwWiki,《AJAX 上手篇》
  • Philip McCarthy,〈面向 Java 開發人員的 Ajax:構建動態的 Java 應用程序〉與〈Ajax 的 Java 物件序列化〉
  • David Flanagan,《JavaScript 權威指南》

版權說明:本文版權歸原作者所有。在免費且無任何附加條件的前提下,可在網路媒體中自由傳播;如需部分或全文引用,請事先徵求作者意見。若本文對您有些許幫助,表達謝意最好的方式就是把您發現的問題與改進意見回饋給作者。

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