DIV CSS 佈局教程網

JSP 結合 Bootstrap Paginator 實作分頁顯示
編輯:關於JavaScript     

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

效果如下:

GitHub 專案位址:https://github.com/lyonlai/bootstrap-paginator

以下說明如何用它完成 JSP 的分頁顯示(為了聚焦,本文省略了大量與分頁無關的內容)。

一、為什麼要分頁

當查詢結果可能有成千上萬筆時,一次全部輸出對資料庫、網路與瀏覽器都是沈重負擔。分頁的核心意義是:只取使用者當下要看的那一小段資料,並讓資料庫層就完成裁剪,而不是查完再於記憶體中切。

二、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 與 DBUtil 兩個輔助類

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 的參數佔位符 ?,避免任何拼接字串的機會。另外資料庫連線資訊(帳號、密碼)應放在外部設定檔或環境變數,不要寫死在原始碼裡。

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