先介紹一款簡潔好用的分頁工具:bootstrap-paginator,它是 Bootstrap 生態裡最常被拿來做分頁條的插件之一。
效果如下:

GitHub 專案位址:https://github.com/lyonlai/bootstrap-paginator
以下說明如何用它完成 JSP 的分頁顯示(為了聚焦,本文省略了大量與分頁無關的內容)。
當查詢結果可能有成千上萬筆時,一次全部輸出對資料庫、網路與瀏覽器都是沈重負擔。分頁的核心意義是:只取使用者當下要看的那一小段資料,並讓資料庫層就完成裁剪,而不是查完再於記憶體中切。
本例直接在 JSP 中用 JDBC 查詢 SQL Server。要強調的是,實際專案中不建議把商業邏輯寫在 JSP 裡——JSP 只該負責顯示,請求分派、業務呼叫與結果轉發都應交由 Servlet 處理。這裡這樣寫只是為了讓範例夠短。
<%@ page import="PaginationExample.*" %>
<%@ page import="java.util.*"%>
<%@ page import="java.sql.*"%>
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%!
private static final int pageSize = 20; // 每頁顯示 20 筆
%>
<%
request.setCharacterEncoding("UTF-8");
response.setCharacterEncoding("UTF-8");
response.setContentType("text/html;charset=UTF-8");
String pageNoStr = request.getParameter("pageNoStr");
int pageNo = 1; // 目前頁碼
int totalPages = 1; // 總頁數
// 檢查並修正 pageNo
if (pageNoStr != null && !pageNoStr.equals("")) {
try {
pageNo = Integer.parseInt(pageNoStr);
if (pageNo < 1) { pageNo = 1; }
} catch (NumberFormatException e) {
pageNo = 1; // 不合法時回到第一頁
}
} else {
pageNo = 1;
}
/* ============ 先算出總頁數 ============ */
Connection totalConn = null;
Statement totalStmt = null;
ResultSet totalRs = null;
try {
totalConn = DBUtil.getConnection();
String sqlGetTotalPages = "select count(*) from alldata";
totalStmt = totalConn.createStatement();
totalRs = totalStmt.executeQuery(sqlGetTotalPages);
totalRs.next();
int countResult = totalRs.getInt(1);
totalPages = countResult % pageSize == 0
? countResult / pageSize
: (int)(countResult / pageSize) + 1;
} catch (SQLException e) {
e.printStackTrace();
} finally {
DBUtil.close(totalRs);
DBUtil.close(totalStmt);
DBUtil.close(totalConn);
}
// 頁碼超過總頁數時,顯示最後一頁
if (pageNo > totalPages) { pageNo = totalPages; }
/* ============ 取出當前頁要顯示的記錄 ============ */
List<Record> records = new ArrayList<Record>();
Connection conn = null;
PreparedStatement pstmt = null;
ResultSet rs = null;
int startIndex = (pageNo - 1) * pageSize + 1;
int endIndex = pageNo * pageSize;
try {
conn = DBUtil.getConnection();
String sql = "select * from ("
+ " select row_number() over(order by data_taizhan_num, data_date asc) as 'num', *"
+ " from alldata"
+ ") as temp where num between " + startIndex + " and " + endIndex;
pstmt = conn.prepareStatement(sql);
rs = pstmt.executeQuery();
while (rs.next()) {
Record r = new Record();
r.setTaizhan_num(rs.getString(2));
r.setDate(rs.getTimestamp(3));
r.setTem(rs.getString(4));
r.setHum(rs.getString(5));
r.setPa(rs.getString(6));
r.setRain(rs.getString(7));
r.setWin_dir(rs.getString(8));
r.setWin_sp(rs.getString(9));
records.add(r);
}
} catch (SQLException e) {
e.printStackTrace();
} finally {
DBUtil.close(rs);
DBUtil.close(pstmt);
DBUtil.close(conn);
}
%>
接著是顯示部分,並在底部掛上分頁條:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
<html lang="zh-CN">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="css/bootstrap.css">
<link rel="stylesheet" href="css/recordSearchResult.css">
<script type="text/javascript" src="js/jquery-1.12.3.min.js"></script>
<script type="text/javascript" src="js/bootstrap.min.js"></script>
<script type="text/javascript" src="js/bootstrap-paginator.min.js"></script>
<title>查詢結果</title>
</head>
<body>
<div class="container">
<div class="wrapper">
<form class="form-area">
<table class="table table-striped table-hover">
<% if (records == null || records.size() == 0) { %>
<tr><td><h4><strong>沒有符合條件的記錄,換個條件試試吧。</strong></h4></td></tr>
<% } else { %>
<tr>
<td><h4><strong>觀測台站</strong></h4></td>
<% Record r = records.get(0);
if (r.getTem() != null) { out.println("<td><h4><strong>溫度(℃)</strong></h4></td>"); }
if (r.getHum() != null) { out.println("<td><h4><strong>濕度(%)</strong></h4></td>"); }
if (r.getPa() != null) { out.println("<td><h4><strong>壓強(hPa)</strong></h4></td>"); }
if (r.getRain() != null) { out.println("<td><h4><strong>雨量(mm)</strong></h4></td>"); }
if (r.getWin_dir() != null) { out.println("<td><h4><strong>風向(°)</strong></h4></td>"); }
if (r.getWin_sp() != null) { out.println("<td><h4><strong>風速(m/s)</strong></h4></td>"); }
%>
<td><h4><strong>觀測時間</strong></h4></td>
</tr>
<% } %>
<% if (records != null && records.size() != 0) {
for (Record r : records) { %>
<tr>
<td><%= r.getTaizhan_num() %></td>
<% if (r.getTem() != null) { out.println("<td>" + r.getTem() + "</td>"); }
if (r.getHum() != null) { out.println("<td>" + r.getHum() + "</td>"); }
if (r.getPa() != null) { out.println("<td>" + r.getPa() + "</td>"); }
if (r.getRain() != null) { out.println("<td>" + r.getRain() + "</td>"); }
if (r.getWin_dir() != null) { out.println("<td>" + r.getWin_dir() + "</td>"); }
if (r.getWin_sp() != null) { out.println("<td>" + r.getWin_sp() + "</td>"); }
%>
<td><%= r.getDate() %></td>
</tr>
<% } } %>
</table>
<!-- 分頁條 -->
<div align="center">
<ul class="pagination" id="paginator"></ul>
</div>
</form>
</div>
</div>
<script type="text/javascript">
var options = {
bootstrapMajorVersion: 3, // 對應的 Bootstrap 版本
size: 'normal',
itemTexts: function(type, page, current) {
switch (type) {
case "first": return "首頁";
case "prev": return "上一頁";
case "next": return "下一頁";
case "last": return "末頁";
case "page": return page;
}
},
tooltipTitles: function(type, page, current) {
switch (type) {
case "first": return "首頁";
case "prev": return "上一頁";
case "next": return "下一頁";
case "last": return "末頁";
case "page": return "第" + page + "頁";
}
},
pageUrl: function(type, page, current) {
return "showInfoSearchResult.jsp?pageNoStr=" + page;
},
numberOfPages: 6, // 一次顯示幾個頁碼
currentPage: <%= pageNo %>, // 當前頁
totalPages: <%= totalPages %> // 總頁數
};
$('#paginator').bootstrapPaginator(options);
</script>
</body>
</html>
Record 只是一個承載資料的 POJO,屬性與資料表欄位一一對應,對外只提供 get / set:
package PaginationExample;
import java.sql.*;
public class Record {
private String taizhan_num; // 台站名
private String tem; // 溫度
private String hum; // 濕度
private String pa; // 壓強
private String rain; // 雨量
private String win_dir; // 風向
private String win_sp; // 風速
private Timestamp date; // 觀測時間
public String getTaizhan_num() { return taizhan_num; }
public void setTaizhan_num(String v) { this.taizhan_num = v; }
public String getTem() { return tem; }
public void setTem(String v) { this.tem = v; }
public String getHum() { return hum; }
public void setHum(String v) { this.hum = v; }
public String getPa() { return pa; }
public void setPa(String v) { this.pa = v; }
public String getRain() { return rain; }
public void setRain(String v) { this.rain = v; }
public String getWin_dir() { return win_dir; }
public void setWin_dir(String v) { this.win_dir = v; }
public String getWin_sp() { return win_sp; }
public void setWin_sp(String v) { this.win_sp = v; }
public Timestamp getDate() { return date; }
public void setDate(Timestamp v) { this.date = v; }
}
對應的 alldata 表部分資料如下:

DBUtil 則是資料庫工具類,統一對外提供 Connection 與各項 close 方法,這裡採用 Tomcat JDBC Pool 做連線池:
package PaginationExample;
import java.sql.*;
import org.apache.tomcat.jdbc.pool.DataSource;
import org.apache.tomcat.jdbc.pool.PoolProperties;
public class DBUtil {
private static DataSource ds;
static {
PoolProperties p = new PoolProperties();
p.setUrl("jdbc:sqlserver://localhost:1433; DatabaseName=weather");
p.setDriverClassName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
p.setUsername("sa");
p.setPassword("你的密碼"); // 請勿把實際密碼寫進原始碼
p.setJmxEnabled(true);
p.setTestWhileIdle(false);
p.setTestOnBorrow(true);
p.setValidationQuery("SELECT 1");
p.setTestOnReturn(false);
p.setValidationInterval(30000);
p.setTimeBetweenEvictionRunsMillis(30000);
p.setMaxActive(100);
p.setInitialSize(10);
p.setMaxWait(10000);
p.setRemoveAbandonedTimeout(60);
p.setMinEvictableIdleTimeMillis(30000);
p.setMinIdle(10);
p.setLogAbandoned(true);
p.setRemoveAbandoned(true);
p.setJdbcInterceptors(
"org.apache.tomcat.jdbc.pool.interceptor.ConnectionState;"
+ "org.apache.tomcat.jdbc.pool.interceptor.StatementFinalizer");
ds = new DataSource();
ds.setPoolProperties(p);
}
private DBUtil() {}
public static Connection getConnection() {
try {
return ds.getConnection();
} catch (SQLException e) {
e.printStackTrace();
return null;
}
}
public static void close(Connection conn) {
try { if (conn != null) { conn.close(); } } catch (SQLException e) { e.printStackTrace(); }
}
public static void close(Statement stmt) {
try { if (stmt != null) { stmt.close(); } } catch (SQLException e) { e.printStackTrace(); }
}
public static void close(ResultSet rs) {
try { if (rs != null) { rs.close(); } } catch (SQLException e) { e.printStackTrace(); }
}
}
① SQL Server 的分頁靠 ROW_NUMBER()。它會產生一個記錄行號的欄位,方便後續用 BETWEEN 取出特定區間:

可以看到最前面多了一個名為 num 的行號欄位。若表的主鍵本身是連續自動遞增的數字,也可以直接用 id 分段;但前提是 id 絕不能中斷,一旦有刪除過的紀錄就會出錯,所以 ROW_NUMBER() 是比較穩定的做法。SQL Server 2012 以後也可以直接用 OFFSET ... FETCH NEXT,語法更簡潔。
② MySQL 的分頁簡單得多。直接用 limit:
select * from table1 order by id asc limit 3, 2
意思是把 table1 依 id 升冪排序後,從第 3 筆之後開始取 2 筆(也就是第 4、5 筆)。注意 limit 的偏移量是 0-based,這與本文的 startIndex 算法不同,實作時別混淆。
③ bootstrap-paginator 的版本對應。官方文件寫得很好,就在解壓後的 document 資料夾裡。使用時要注意:Bootstrap 3 必須用 <ul> 標籤承載,並在設定中明確標注版本號(如上例的 bootstrapMajorVersion);Bootstrap 2 則可直接用文件範例中的 <div>。
④ 分頁公式要記牢。設當前頁碼為 n、每頁 m 筆,則待取資料的起始位置 startIndex 為 (n-1)*m+1,結束位置 endIndex 為 n*m。
⑤ 一個安全提醒。範例把 pageNo 直接拼進 SQL 字串。雖然上面有做 parseInt 轉換與範圍檢查,實務上仍應改用 PreparedStatement 的參數佔位符 ?,避免任何拼接字串的機會。另外資料庫連線資訊(帳號、密碼)應放在外部設定檔或環境變數,不要寫死在原始碼裡。