前言

好久沒寫Web程序了，這一段時(shí)間看了看原來師弟們做的一些程序，感覺還是有很多不足，一個(gè)比較典型的例子就是分頁查詢的實(shí)現(xiàn)，正好借著這個(gè)機(jī)會(huì)簡單記錄一下。

分析

使用場景

“分頁”在Web程序里非常常見，比如我們?cè)陧撁嫔辖?jīng)常要展示一些列表信息，通常情況下，如果數(shù)據(jù)過多，我們?cè)谝黄辽想y以羅列出所有的記錄，而且很多時(shí)候我們可能只是看看比較Top的一些記錄，因此，在這種情況下使用“分頁”查詢只展示部分?jǐn)?shù)據(jù)是比較合適的。

實(shí)現(xiàn)原理

從數(shù)據(jù)庫角度上來說，分頁查詢實(shí)現(xiàn)的難度并不是很大，當(dāng)然不同的數(shù)據(jù)庫實(shí)現(xiàn)是有一些差異的。以MySQL為例，我們通常會(huì)寫出如下的SQL語句：

# 簡單的單表查詢
select [fields] from [table_name] where [expression] order by [field] [asc|desc] limit [offset], [size]

其中有幾處地方我們比較關(guān)注，第一個(gè)就是order by后的字段field和排順規(guī)則，第二個(gè)就是limit之后的數(shù)據(jù)偏移量offset和大小size。

所以，以上幾個(gè)參數(shù)是我們實(shí)現(xiàn)分頁查詢一個(gè)關(guān)鍵。

實(shí)現(xiàn)

這里的實(shí)現(xiàn)主要是指Java后臺(tái)的實(shí)現(xiàn)，關(guān)于如何編寫一個(gè)前端分頁插件不在此文的討論之列。我們來簡單梳理一下整個(gè)業(yè)務(wù)邏輯的交互過程，就是”前端查詢參數(shù)”->”后臺(tái)業(yè)務(wù)邏輯查詢”->”返回結(jié)果集到前端”。

那么問題來了，前端一般要傳遞哪些參數(shù)到服務(wù)器后臺(tái)呢？

回到上面的實(shí)現(xiàn)原理上，我們發(fā)現(xiàn)，這4個(gè)參數(shù)我們都是需要的，而且它們不是固定的。從開發(fā)角度上來講，我們首先需要的參數(shù)是sortField，sortOrder，即排一定的計(jì)算序字段和排序方式，offset我們通常會(huì)根據(jù)一定的計(jì)算規(guī)則進(jìn)行計(jì)算，一般在頁面上我們使用的是pageCurrent，即用戶需要查詢的頁數(shù)，另外頁面還必須傳遞一個(gè)參數(shù)即pageSize，即每頁要顯示的數(shù)據(jù)總量，這樣，我們就可以根據(jù)pageCurrent和pageSize來計(jì)算出offset和size，計(jì)算公式如下所示：

offset=(pageCurrent−1)∗pageSize
size=pageSize

OK，我們梳理出來了4個(gè)字段，即sortField，sorOrder，pageCurrent和pageSize。這些參數(shù)是前臺(tái)應(yīng)該傳遞給后臺(tái)服務(wù)的，當(dāng)然，從程序的健壯性來說，如果用戶不傳遞這些字段，我們也應(yīng)該有一些默認(rèn)的實(shí)現(xiàn)，比如說如果不傳遞當(dāng)前頁數(shù)，我們默認(rèn)就是第一頁，如果不傳遞pageSize，我們可以默認(rèn)其大小為每頁30條……那么，第一個(gè)Java Bean就出來了，我們稱為PageParam類。

 public class PageParam {
  private static final Integer DEFAULT_PAGE_CURRENT = 1;
  private static final Integer DEFAULT_PAGE_SIZE = 30;
  /**
   * 排序字段
   */
  private String sortField;
  /**
   * 排序方式
   * asc | desc
   */
  private String sortOrder;
  /**
   * 查詢的當(dāng)前頁
   */
  private Integer pageCurrent = DEFAULT_PAGE_CURRENT;
  /**
   * 查詢的數(shù)據(jù)條目
   */
  private Integer pageSize = DEFAULT_PAGE_SIZE;
  ......
}

現(xiàn)在，我們先忽略服務(wù)器端的具體處理流程，來思考一下服務(wù)器端需要返回哪些信息到前端頁面上進(jìn)行展示。
下面是我從網(wǎng)上截取的一個(gè)典型分頁界面（如不能引用請(qǐng)私信我）：

通過分析，可以看到，當(dāng)前頁pageCurrent是需要的，且通常會(huì)特殊展示。另外如果頁數(shù)過多，在前端界面里通常只會(huì)展示部分頁值，那么我們也需要來進(jìn)行判斷，通常情況下我們通過判斷總頁數(shù)即可，那么總頁數(shù)totalPage是需要的。當(dāng)然，還有一些隱含的參數(shù)我們通常也是要傳遞給前端進(jìn)行相關(guān)的業(yè)務(wù)處理的，比如說數(shù)據(jù)的總條目totalSize和一頁顯示的數(shù)量pageSize，這些通常都會(huì)在頁面進(jìn)行展示。第二個(gè)Java Bean我們成為PageResult類：

public class PageResult<T> {
  /**
   * 返回的數(shù)據(jù)結(jié)果集
   */
  private List<T> resultList;
  /**
   * 總數(shù)據(jù)條目
   */
  private Integer totalSize;
  /**
   * 總頁數(shù)
   */
  private Integer totalPage;
  /**
   * 當(dāng)前頁
   */
  private Integer pageCurrent;
  /**
   * 顯示的數(shù)據(jù)條目
   */
  private Integer pageSize;
  ......
}

這里totalPage其實(shí)是可以根據(jù)pageSize和totalSize進(jìn)行計(jì)算出來的，計(jì)算公式如下：

totalPage=totalSize%pageSize==0?totalSize/pageSize:(totalSize/pageSize+1)

在實(shí)現(xiàn)里，我們對(duì)結(jié)果集使用了泛型，主要是為了通用處理。還差最后一點(diǎn)，就是服務(wù)器端的處理邏輯，這里不太好說的原因在于現(xiàn)在服務(wù)器端的框架太多，如MyBatis，spring JDBC，hibernate等等。不同的框架使用上是有較大差別的，不過有一些比較通用的做法這里簡單記錄一下。

對(duì)任何前端傳遞過來的參數(shù)都必須進(jìn)行校驗(yàn)。這里主要是pageCurrent和pageSize，因?yàn)橛脩艉芸赡軅鬟f過來一些無效值，比如負(fù)值-1以及一些不合適值如pageSize取100000000等。

排序字段不是必須的。要根據(jù)業(yè)務(wù)來處理，因?yàn)楹芏鄷r(shí)候通過id或者其它字段默認(rèn)實(shí)現(xiàn)就可以了，不需要進(jìn)行重新排序。
pageSize的值要合適。如果太小會(huì)造成頁面過于空洞，頁數(shù)過多；而取值過大則會(huì)使頁面內(nèi)容繁雜，通常在一屏比較合適，不需要用戶拉動(dòng)滑動(dòng)條。

以上所述是小編給大家介紹的Java Web中常用的分頁組件（Java端實(shí)現(xiàn)），希望對(duì)大家有所幫助，如果大家有任何疑問請(qǐng)給我留言，小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)腳本之家網(wǎng)站的支持！

最新評(píng)論