分頁是列表頁的標配,而「後端只回傳 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,否則中文欄位在不同伺服器設定下可能亂碼。
<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 萬筆,每次請求的負載都相同。這是本範例架構上最需要修正的一點。
renderRow 用字串拼接把 item.remark 直接塞進 HTML。若備註欄位含 <img src=x onerror=alert(1)>,這段程式碼會執行。改用 $('<span>', { text: item.remark }) 讓 jQuery 自動轉義,或建好結構後用 .text() 填入。input <= pageTotal 在輸入 "abc" 時會是 false 而落入 else,看似正常;但輸入 "2.5" 或 "2abc" 時行為難以預期。應先 parseInt 並用 isNaN 檢查。getPage() 與 getJSONData() 各自請求了一次。既然總數在第一次回應裡就有,後續翻頁應該把 pageTotal 快取起來,避免重複往返。若你的專案已在用 jQuery,可以考慮 DataTables 的伺服器端模式,它已把上述所有細節(含 debounce、排序、篩選)處理完畢;否則 jQuery Pagination 這類輕量插件也勝過自己攢。