引言

分頁(yè)和排序是數(shù)據(jù)庫(kù)提供的兩項(xiàng)基本的查詢功能。

以MySQL為例，一條典型的SQL查詢語(yǔ)句如下：

SELECT * FROM t_user
ORDER BY create_time DESC, username ASC
LIMIT 10 OFFSET 20

那么在前后端交互中，前端應(yīng)該如何向后端傳遞分頁(yè)和排序有關(guān)的信息呢？需要傳遞哪些參數(shù)？參數(shù)的意義和格式又是什么？

分頁(yè)

分頁(yè)的語(yǔ)句為LIMIT 10 OFFSET 20，其中10為每頁(yè)的大小，20為查詢的偏移量，也就是查詢表中的第21到30條共計(jì)10條數(shù)據(jù)。

但是在設(shè)計(jì)接口時(shí)，通常不會(huì)要求前端直接傳入OFFSET參數(shù)，而是通過(guò)傳入頁(yè)號(hào)和分頁(yè)大小，來(lái)計(jì)算出OFFSET的值。

在這個(gè)例子中，假設(shè)前端的頁(yè)號(hào)從1開始，那么需要查詢的數(shù)據(jù)就是分頁(yè)大小為10的第3頁(yè)數(shù)據(jù)，對(duì)應(yīng)的OFFSET的值的計(jì)算式為(3-1)*10 = 20。

前端在調(diào)用后端查詢接口時(shí)，通常會(huì)傳入頁(yè)號(hào)和每頁(yè)大小，由后端計(jì)算出OFFSET用于分頁(yè)查詢。這里頁(yè)號(hào)的參數(shù)名稱定義為pageNumber，分頁(yè)大小的參數(shù)名定義為pageSize, 則以起始頁(yè)號(hào)為1為例，OFFSET的計(jì)算公式為：

(pageNumber - 1) * pageSize

而前端的傳值應(yīng)為

?pageNumber=3&pageSize=10

分頁(yè)接口

不同的數(shù)據(jù)庫(kù)的分頁(yè)語(yǔ)句并不一致，但是一般都需要三個(gè)參數(shù)：SQL語(yǔ)句，分頁(yè)大小，偏移量，所以定義一個(gè)構(gòu)建分頁(yè)語(yǔ)句的接口Dialect，根據(jù)訪問(wèn)的數(shù)據(jù)庫(kù)提供對(duì)應(yīng)的分頁(yè)實(shí)現(xiàn)。

public interface Dialect {
    String buildPageSql(String sql, int limit, long offset);
}

排序

排序的語(yǔ)句為ORDER BY create_time DESC, username ASC, 其中ORDER BY為SQL的關(guān)鍵字，可以將其定義為參數(shù)名。因?yàn)槭怯糜谂判?，所以我將其取名?code>sort，對(duì)應(yīng)的值為create_time DESC, username ASC。因?yàn)榍岸薌ET請(qǐng)求需要對(duì)參數(shù)值里的空格進(jìn)行轉(zhuǎn)義，為避免這個(gè)問(wèn)題，將值里的,轉(zhuǎn)為;，將DESC/ASC前的空格轉(zhuǎn)為,，最終前端傳值如下：

?sort=create_time,desc;username,asc

請(qǐng)求對(duì)象

綜合以上分頁(yè)和排序的參數(shù)定義和說(shuō)明，前端的傳值如下：

?pageNumber=3&pageSize=10&sort=create_time,desc;username,asc

那么后端就可以定義如下PageQuery類用于分頁(yè)和排序參數(shù)的處理：

public class PageQuery {
    private Integer pageNumber;
    private Integer pageSize;
    private String sort;
}

每條查詢都有進(jìn)行顯示或隱式的分頁(yè)和排序，比如：

SELECT * FROM t_user

和

SELECT * FROM t_user
ORDER BY id ASC
LIMIT ∞ OFFSET 0

等價(jià)。

所以PageQuery應(yīng)當(dāng)作為所有查詢對(duì)象的父類，以便為數(shù)據(jù)查詢提供分頁(yè)和排序的能力。

響應(yīng)對(duì)象

對(duì)于前端的分頁(yè)查詢請(qǐng)求，除了返回對(duì)應(yīng)的數(shù)據(jù)列表外，還需要返回總的數(shù)據(jù)條數(shù)total以幫助前端計(jì)算總頁(yè)數(shù)，計(jì)算公式為⌈total/size⌉。對(duì)應(yīng)的響應(yīng)對(duì)象定義如下：

public class PageList<T> {
    private final List<T> list;
    private final long total;
}

小結(jié)

本篇主要介紹了DoytoQuery中對(duì)于數(shù)據(jù)庫(kù)查詢中分頁(yè)和排序功能的一種面向?qū)ο蟮慕鉀Q方案，就這。更多關(guān)于DoytoQuery分頁(yè)排序的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論