DIV CSS 佈局教程網

Ajax 以 XML 非同步取回資料,實作省市二級連動
編輯:AJAX基礎知識     

過去做省市連動,多是把資料寫在 JavaScript 陣列裡。但實務上更常見的需求是資料來自資料庫——城市可能隨時增刪,寫死在前端遲早出問題。這時就該改用非同步提交、局部刷新的思路。以下示範以 XML 作為資料格式的作法。

步驟一:建立 XHR 物件

這段程式碼是通用的,放在函式外即可供所有函式共用:

var xhr = false;
if (window.XMLHttpRequest) {
    xhr = new XMLHttpRequest();
} else if (window.ActiveXObject) {
    xhr = new ActiveXObject("Microsoft.XMLHTTP");
} else {
    xhr = false;
}

步驟二:把選取的省份傳給伺服器

function getCity() {
    var provinceobj = document.getElementById("province");
    var index = provinceobj.selectedIndex;
    var provincevalue = provinceobj[index].value;   // 省份的 value
    // var province = provinceobj[index].text;      // 省份顯示文字

    var url = "<%=basepath%>CityServlet";
    // 若用 get,參數直接接在 url 後:
    // var url = "<%=basepath%>CityServlet?provincevalue=" + provincevalue;

    xhr.open("post", url, true);   // true 表示非同步

    // post 提交時需指定編碼,否則後端可能收到亂碼
    xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

    // 綁定狀態變化時的回呼
    xhr.onreadystatechange = callBack_XML;

    // post 的資料要放在 send 裡
    xhr.send("provincevalue=" + provincevalue);
}

順帶一提,中文值若直接接在 URL 後以 get 送出,務必先 encodeURIComponent(),否則編碼不一致時後端會拿到亂碼。這也是多數人偏好用 post 的原因。

步驟三:撰寫回呼函式

function callBack_XML() {
    var cityobj = document.getElementById("city");

    // 4 代表回應已完成,可以使用
    if (xhr.readyState == 4) {
        if (xhr.status == 200) {
            // 取得 XML 文件
            var cityxml = xhr.responseXML;
            var root = cityxml.documentElement;
            var cities = root.getElementsByTagName("city");

            // 清空城市下拉選單,保留第一個提示項
            cityobj.options.length = 1;

            for (var i = 0; i < cities.length; i++) {
                var city = cities[i];
                var cid = city.childNodes[0].firstChild.nodeValue;
                var cname = city.childNodes[2].firstChild.nodeValue;
                // new Option(顯示文字, 值)
                cityobj.options[cityobj.options.length] = new Option(cname, cid);
            }
        } else if (xhr.status == 404) {
            alert("找不到請求的網址!");
        } else {
            alert("發生錯誤,狀態碼:" + xhr.status);
        }
    }
}

這裡用 childNodes[索引] 取值,其實相当脆弱:瀏覽器會把標籤之間的換行與縮排也計為文字節點,導致索引錯位。更穩健的寫法是改用 childNodes 前先以 getElementsByTagName("id")[0] 精準定位,或直接改用 JSON 這種不必解析節點的格式。

步驟四:伺服器端產生 XML

String provincevalue = request.getParameter("provincevalue");
CityService cityservice = CityService.getCityService();
List<City> citylist = cityservice.getCity(provincevalue);

StringBuffer xml = new StringBuffer();
xml.append("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
xml.append("<city_info>");
for (City c : citylist) {
    xml.append("<city>");
    xml.append("<id>" + c.getId() + "</id>");
    xml.append("<cityid>" + c.getCityid() + "</cityid>");
    xml.append("<cityname>" + c.getCity() + "</cityname>");
    xml.append("<province>" + c.getFather() + "</province>");
    xml.append("</city>");
}
xml.append("</city_info>");

// 設定編碼,避免中文亂碼
response.setCharacterEncoding("utf-8");
response.setContentType("text/xml;charset=utf-8");

PrintWriter writer = response.getWriter();
writer.write(xml.toString());
writer.flush();
writer.close();

兩個必須修正的問題

一、XML 拼接未做跳脫。城市名稱若含 &、< 等字元,會直接破壞文件結構。請改用既有的 XML 函式庫產生文件,讓跳脫交給函式庫處理。

二、回應標頭建議加上 Cache-Control: no-cache。某些瀏覽器會快取 XHR 的 GET 回應,導致切換省份後城市清單沒更新。加上禁止快取的標頭,或在 URL 附帶隨機參數,都能避免這個經典問題。

結語

以 XML 實作二級連動的重點不在語法,而在三件事:編碼一致、禁止快取、以及節點定位要穩健。若專案沒有對接既有 XML 服務的壓力,改用 JSON 會省下大量解析程式碼——伺服器端 json_encode(),客戶端 JSON.parse(),城市清單就是一個陣列,迴圈一跑即完成。

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