DoytoQuery中的分页排序方案示例详解
目录
- 引言
- 分页
- 分页接口
- 排序
- 请求对象
- 响应对象
- 小结
引言
分页和排序是数据库提供的两项基本的查询功能。
以MySQL为例,一条典型的SQL查询语句如下:
SELECT * FROM t_user ORDER BY create_time DESC, username ASC LIMIT 10 OFFSET 20
那么在前后端交互中,前端应该如何向后端传递分页和排序有关的信息呢?需要传递哪些参数?参数的意义和格式又是什么?
分页
分页的语句为LIMIT 10 OFFSET 20
,其中10
为每页的大小,20
为查询的偏移量,也就是查询表中的第21到30条共计10条数据。
但是在设计接口时,通常不会要求前端直接传入OFFSET
参数,而是通过传入页号和分页大小,来计算出OFFSET
的值。
在这个例子中,假设前端的页号从1开始,那么需要查询的数据就是分页大小为10的第3页数据,对应的OFFSET
的值的计算式为(3-1)*10 = 20
。
前端在调用后端查询接口时,通常会传入页号和每页大小,由后端计算出OFFSET
用于分页查询。这里页号的参数名称定义为pageNumber
,分页大小的参数名定义为pageSize
, 则以起始页号为1为例,OFFSET
的计算公式为:
(pageNumber - 1) * pageSize
而前端的传值应为
?pageNumber=3&pageSize=10
分页接口
不同的数据库的分页语句并不一致,但是一般都需要三个参数:SQL语句,分页大小,偏移量,所以定义一个构建分页语句的接口Dialect,根据访问的数据库提供对应的分页实现。
public interface Dialect { String buildPageSql(String sql, int limit, long offset); }
排序
排序的语句为ORDER BY create_time DESC, username ASC
, 其中ORDER BY
为SQL的关键字,可以将其定义为参数名。因为是用于排序,所以我将其取名为sort
,对应的值为create_time DESC, username ASC
。因为前端GET请求需要对参数值里的空格进行转义,为避免这个问题,将值里的,
转为;
,将DESC
/ASC
前的空格转为,
,最终前端传值如下:
?sort=create_time,desc;username,asc
请求对象
综合以上分页和排序的参数定义和说明,前端的传值如下:
?pageNumber=3&pageSize=10&sort=create_time,desc;username,asc
那么后端就可以定义如下PageQuery类用于分页和排序参数的处理:
public class PageQuery { private Integer pageNumber; private Integer pageSize; private String sort; }
每条查询都有进行显示或隐式的分页和排序,比如:
SELECT * FROM t_user
和
SELECT * FROM t_user ORDER BY id ASC LIMIT ∞ OFFSET 0
等价。
所以PageQuery
应当作为所有查询对象的父类,以便为数据查询提供分页和排序的能力。
响应对象
对于前端的分页查询请求,除了返回对应的数据列表外,还需要返回总的数据条数total
以帮助前端计算总页数,计算公式为⌈total/size⌉
。对应的响应对象定义如下:
public class PageList<T> { private final List<T> list; private final long total; }
小结
本篇主要介绍了DoytoQuery中对于数据库查询中分页和排序功能的一种面向对象的解决方案,就这。更多关于DoytoQuery分页排序的资料请关注我们其它相关文章!