DIV CSS 佈局教程網

jQuery + Ajax + JSON 實作分頁列表:後端組裝到前端渲染全流程
編輯:JQuery特效代碼     

分頁是列表頁的標配,而「後端只回傳 JSON、前端負責渲染與翻頁」是負擔最輕、擴充性最好的架構。以下從後端產生資料開始,一路做到前端可翻頁、可跳頁的完整列表。

一、後端產生 JSON

List blackList = blackService.getBlackInfoList(
        mobileNum, gatewayid, startDate, endDate);
int totalRows = blackList.size();

StringBuffer sb = new StringBuffer();
sb.append("{\"totalCount\":\"" + totalRows + "\",");
sb.append("\"jsonRoot\":[");

for (int i = 0; i < blackList.size(); i++) {
    LBlack blackInfo = (LBlack) blackList.get(i);
    sb.append("{\"id\":\""       + blackInfo.getId()        + "\",");
    sb.append("\"mobile\":\""   + blackInfo.getMobile()    + "\",");
    sb.append("\"province\":\"" + blackInfo.getProvince()  + "\",");
    sb.append("\"gateway\":\""  + blackInfo.getGateway()   + "\",");
    sb.append("\"insertTime\":\"" + blackInfo.getInsertTime() + "\",");
    sb.append("\"remark\":\""   + blackInfo.getRemark()    + "\"");
    sb.append("},");
}
sb.deleteCharAt(sb.lastIndexOf(","));   // 刪去最後一個逗號
sb.append("]}");

HttpServletResponse response = ServletActionContext.getResponse();
response.setContentType("text/plain");
response.getWriter().print(sb);

這段程式不該這樣寫,原因很實際:手拼 JSON 只要資料中出現雙引號、反斜線或換行,整份 JSON 就失效,前端會收到 parse error。使用者如果在「備註」欄位打一個引號,你的列表就空了。

正確做法是用序列化器,讓它負責所有轉義:

List<LBlack> list = blackService.getBlackInfoList(mobileNum, gatewayid, startDate, endDate);

Map<String, Object> result = new HashMap<>();
result.put("totalCount", list.size());
result.put("jsonRoot", list);

response.setContentType("application/json;charset=UTF-8");
response.getWriter().print(new Gson().toJson(result));

或用 Jackson 的 ObjectMapper。另外,Content-Type 應為 application/json 而非 text/plain,並明確標註 UTF-8,否則中文欄位在不同伺服器設定下可能亂碼。

二、Struts 配置

<action name="blackList" class="blackAction" method="blackList">
  <!-- plainText 用於顯示頁面原始碼的結果類型 -->
  <result type="plainText">
    <param name="charSet">UTF-8</param>
    <param name="location">/WEB-INF/jsp/manage/black.jsp</param>
  </result>
</action>

三、前端:取得資料並分頁渲染

function getJSONData(pn) {
    $.getJSON("blackList.ce", function (data) {
        var totalCount = data.totalCount;   // 總記錄數
        var pageSize   = 10;                // 每頁筆數
        var pageTotal  = Math.ceil(totalCount / pageSize);

        var startPage = pageSize * (pn - 1);
        var endPage   = startPage + pageSize - 1;

        var $ul = $("#json-list");
        $ul.empty();

        for (var i = 0; i < pageSize; i++) {
            $ul.append('<li class="li-tag"></li>');
        }

        var dataRoot = data.jsonRoot;

        if (pageTotal == 1) {
            // 只有一頁
            for (var j = 0; j < totalCount; j++) {
                renderRow($(".li-tag").eq(j), j, dataRoot[j]);
            }
        } else {
            for (var j = startPage, k = 0; j < endPage && k < pageSize; j++, k++) {
                if (j == totalCount) { break; }      // 最後一筆
                renderRow($(".li-tag").eq(k), j, dataRoot[j]);
            }
        }

        $(".page-count").text(pageTotal);
    });
}

// 抽出來的單列渲染函式
function renderRow($li, index, item) {
    $li.append("<span class='col1'><input type='checkbox' value='" + (index + 1) + "'/></span>")
       .append("<span class='col2'>" + (index + 1) + "</span>")
       .append("<span class='col3'>" + item.mobile    + "</span>")
       .append("<span class='col4'>" + item.province  + "</span>")
       .append("<span class='col5'>" + item.gateway   + "</span>")
       .append("<span class='col6'>" + item.insertTime + "</span>")
       .append("<span class='col7'>" + item.remark    + "</span>");
}

把單列渲染抽成獨立函式,是這裡最該做的一個重構。原範例中那段 append 鏈在 if 與 else 裡各複製了一次,改資料欄位得改兩處,很容易漏。

四、翻頁控制

function getPage() {
    $.getJSON("blackList.ce", function (data) {
        var pn = 1;
        var totalCount = data.totalCount;
        var pageSize   = 10;
        var pageTotal  = Math.ceil(totalCount / pageSize);

        $("#next").click(function () {
            if (pn == pageTotal) { alert("後面沒有了"); pn = pageTotal; }
            else { pn++; gotoPage(pn); }
        });

        $("#prev").click(function () {
            if (pn == 1) { alert("前面沒有了"); pn = 1; }
            else { pn--; gotoPage(pn); }
        });

        $("#firstPage").click(function () { pn = 1;        gotoPage(pn); });
        $("#lastPage").click (function () { pn = pageTotal; gotoPage(pn); });

        $("#page-jump").click(function () {
            var input = $(".page-num").val();
            if (input <= pageTotal && input != '') {
                pn = input;
                gotoPage(pn);
            } else {
                alert("您輸入的頁碼有誤!");
                $(".page-num").val('').focus();
            }
        });

        $("#firstPage").trigger("click");
    });
}

function gotoPage(pn) {
    $(".current-page").text(pn);
    getJSONData(pn);
}

$(function () { getPage(); });

這個實作最關鍵的缺陷

分頁是假的。後端每次都回傳「全部資料」,前端只是用 JavaScript 切出目前這一頁要顯示的部分。這在幾十筆時沒問題,但資料一多就會全面崩塌:網路傳輸量隨總筆數線性成長、瀏覽器要解析越來越大的 JSON、使用者翻到後面會明顯卡頓。

真正的分頁必須把 page 與 pageSize 送到後端,由資料庫以 LIMIT/OFFSET 只取該頁的 10 筆:

$.getJSON("blackList.ce", { page: pn, rows: pageSize }, function (data) {
    // data 只含當頁 10 筆 + 總數
});

這樣一來,無論總資料量是 100 筆還是 100 萬筆,每次請求的負載都相同。這是本範例架構上最需要修正的一點。

其他值得改進的地方

  • XSS 風險。renderRow 用字串拼接把 item.remark 直接塞進 HTML。若備註欄位含 <img src=x onerror=alert(1)>,這段程式碼會執行。改用 $('<span>', { text: item.remark }) 讓 jQuery 自動轉義,或建好結構後用 .text() 填入。
  • 用 alert 提示沒有資料。翻頁到邊界時彈 alert 打斷操作,體驗不佳。改用 disable 首尾頁按鈕,或讓翻頁器顯示「第 1 / 5 頁」讓狀態自明。
  • 頁碼輸入未驗證型別。input <= pageTotal 在輸入 "abc" 時會是 false 而落入 else,看似正常;但輸入 "2.5" 或 "2abc" 時行為難以預期。應先 parseInt 並用 isNaN 檢查。
  • 兩次請求同一支 API。getPage() 與 getJSONData() 各自請求了一次。既然總數在第一次回應裡就有,後續翻頁應該把 pageTotal 快取起來,避免重複往返。

若你的專案已在用 jQuery,可以考慮 DataTables 的伺服器端模式,它已把上述所有細節(含 debounce、排序、篩選)處理完畢;否則 jQuery Pagination 這類輕量插件也勝過自己攢。

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