pagehelper工具类_PageHelper最佳实践
来源:https://blog.csdn.net/NOT_TWO_CHEN/article/details/109230267
一. 开发准备
1. 开发工具
- IntelliJ IDEA 2020.2.3
2. 开发环境
- Red Hat Open JDK 8u256
- Apache Maven 3.6.3
3. 开发依赖
- SpringBoot
<dependency> <groupId>org.springframework.bootgroupId> <artifactId>spring-boot-starter-webartifactId>dependency>
- MyBatis
<dependency> <groupId>org.mybatis.spring.bootgroupId> <artifactId>mybatis-spring-boot-starterartifactId> <version>2.1.3version>dependency>
- PageHelper
<dependency> <groupId>com.github.pagehelpergroupId> <artifactId>pagehelper-spring-boot-starterartifactId> <version>1.3.0version>dependency>
二. 技术文档
1. 基于SpringBoot
- SpringBoot 官方文档
- SpringBoot 中文社区
2. 基于MyBatis
- MyBatis 官方文档
3. 集成PageHelper
- PageHelper 开源仓库
三. 应用讲解
1. 基本使用
在实际项目运用中,PageHelper的使用非常便利快捷,仅通过PageInfo
+ PageHelper
两个类,就足以完成分页功能,然而往往这种最简单的集成使用方式,却在很多实际应用场景中,没有得到充分的开发利用.
接下来是我们最常见的使用方式:
public PageInfo page(RequestParamDto param) { PageHelper.startPage(param.getPageNum(), param.getPageSize()); List list = mapper.selectManySelective(param); PageInfo pageInfo = (PageInfo)list;return pageInfo;}
在某种程度上而言,上述写法的确是符合PageHelper的使用规范 :
在集合查询前使用
PageHelper.startPage(pageNum,pageSize)
,并且中间不能穿插执行其他SQL
但是作为Developer的我们,往往只有在追求完美和极致的道路上才能够寻得突破和机遇; 以下是合理且规范的基本使用:
public PageInfo page(RequestParamDto param) { return PageHelper.startPage(param.getPageNum(), param.getPageSize()) .doSelectPageInfo(() -> list(param))} public List list(RequestParamDto param) { return mapper.selectManySelective(param);}
FAQ
1. 为什么要重新声明一个list函数?
答: 往往在很多实际业务应用场景中, 分页查询是基于大数据量的表格展示需求来进行的.
然而很多时候,譬如: 内部服务的互相调用,
OpenAPI
的提供.
甚至在某些前后端分离联调的业务场景中,是同样需要一个非分页集合查询接口来提供服务的.
另外,暂时以上因素抛开不谈,我们可以根据上述写法来定义和规范某些东西
譬如: 分页和集合查询的分离和解耦(解耦详情请看进阶使用),
分页请求的请求和响应与实际业务参数的分离(详情请看进阶使用)等等…
2. doSelectPageInfo
是什么?
答:
doSelectPageInfo
是PageHelper.startPage()
函数返回的默认Page
实例内置的函数,该函数可以用以Lambda
的形式通过额外的Function
来进行查询而不需要再进行多余的PageInfo
与List
转换,而doSelectPageInfo
的参数则是PageHelper
内置的Function(ISelect)
接口用以达到转换PageInfo
的目的
3. 这种写法的代码量看起来不少反多?
答: 正如同①中所描述的,就代码量而言,确实没有更进一步的简化,但是再某些业务场景中,在已具有
list
函数接口的情况下,是一种更直观的优化(优化详情请看进阶使用)
2. 进阶使用
先看代码,再谈解析:
import com.github.pagehelper.PageHelper;import com.github.pagehelper.PageInfo;
import java.util.List;
/** * @param 泛型request * @param 泛型response */public interface BaseService<Param, Result> {
/** * 分页查询 * * @param param 请求参数DTO * @return 分页集合 */ default PageInfo page(PageParam param) { return PageHelper.startPage(param).doSelectPageInfo(() -> list(param.getParam())); }
/** * 集合查询 * * @param param 查询参数 * @return 查询响应 */ List list(Param param);}
可以看到
BaseService
可以作为全局Service
通用接口的封装和声明 而作为通用分页接口page函数却在此处利用interface
特有关键字default
直接声明了page
函数的方法体body
import com.github.pagehelper.IPage;import lombok.Data;import lombok.experimental.Accessors;
@Data // 为省略冗余代码使用lombok 实际应有常规Getter/Setter Construction toString等@Accessors(chain = true) // 此lombok注解是为了实现 Entity伪Build 譬如: entity.setX(x).setY(y)public class PageParam<T> implements IPage {
// description = "页码", defaultValue = 1 private Integer pageNum = 1;
// description = "页数", defaultValue = 20 private Integer pageSize = 20;
// description = "排序", example = "id desc" private String orderBy;
// description = "参数" private T param;
public PageParam setOrderBy(String orderBy) { this.orderBy = orderBy; // 此处可优化 优化详情且看解析 return this; }}
在
BaseService
中我们看到了一个新的PageParam
,参考了PageInfo
用以包装/声明/分离分页参数和业务参数,且参数类型为泛型,即支持任何数据类型的业务参数 同时也可以看到PageParam
实现了IPage
接口,并且多了一个orderBy
属性字段
import common.base.BaseService;import dto.req.TemplateReqDto;import dto.resp.TemplateRespDto;
public interface TemplateService extends BaseService<TemplateReqDto, TemplateeRespDto> { // 同为interface接口, 业务Service只需要继承BaseService // 并根据实际使用场景声明请求参数和响应结果的Entity实体即可}
在实际应用中,只需要声明我们通用的业务查询请求参数和响应结果即可
import dto.req.TemplateReqDto;import dto.resp.TemplateRespDto;import service.TemplateService;import persistence.mapper.TemplateMapper;import lombok.RequiredArgsConstructor;import lombok.extern.slf4j.Slf4j;import org.springframework.stereotype.Service;
import java.util.List;
@Slf4j // 基于lombok自动生成logger日志记录实例@Service // SpringBoot中注册Service Bean的注解@RequiredArgsConstructor // 基于lombok根据类所有final属性生成构造函数 即可完成Spring构造注入public class TemplateServiceImpl implements TemplateService {
private final TemplateMapper mapper;
@Override public List list(TemplateReqDto param) { return mapper.selectManySelective(param) // 可根据实际情况将实体做转换 }}
实现类中也只需要重写
list
方法体,将实际业务场景中需要处理的业务逻辑处理和查询方法写入其中,并不需要关心分页功能
@Slf4j // 同上@RestController // SpringBoot中注册Controller Bean的注解@RequiredArgsConstructor // 同上public class TemplateController {
public final TemplateService service;
/** * 分页查询 * * @param pageParam 分页查询参数 * @return 分页查询响应 */ @PostMapping(path = "page") public PageInfo page(@RequestBody PageParam pageParam) { return service.page(pageParam); }
/** * 集合查询 * * @param listParam 集合查询参数 * @return 集合查询响应 */ @PostMapping(path = "list") public List list(@RequestBody Param listParam) { return service.list(listParam); }}
最后编码
Controller
接口时,也只需要直接调用service.page
即可,而请求参数直接用PageParam
包装,将分页参数和业务参数分离,在前后端接口联调中,保持这种分离规范,可以很大程度上的降低沟通和开发成本
FAQ
1. BaseService
作为interface
,page
为什么可以声明方法体?
答:
Java8
中新特性之一就是为interface
接口类增加了static/default
方法,即声明方法后,其子类或实现都将默认具有这些方法,可以直接调用 而在此处为Page
方法声明default
是因为page
函数只关注分页参数和分页响应,脱离了业务场景,方法体大相径庭,所以索性抽象定义出来,免去了其实现的复杂冗余过程
2. PageParam
的声明有什么意义?实现IPage
是为了什么?
答:
PageParam
是参考PageInfo
编写的类(不确定往后PageHelper
是否会封装此类,兴许我可以提个Issue
上去,也参与开源框架的开发) 编写此类的目的就是为了分离分页和业务数据,让开发者专注于业务的实现和开发,同时也是对分页查询API
的一种规范,无论是请求还是响应都将分页相关的数据抽离出来,单独使用 而实现IPage
则是因为IPage
作为PageHelper
内置的interface
,在不了解它更多意义上的作用前,可以作为我们分页参数声明的一种规范,而IPage
中也只声明了三个方法,分别是pageNum/pageSize/orderBy
的Getter
方法,另外在源码分析中,我将会提到实现此接口更深层的意义
3. PageParam
中除了常规的pageNum/pageSize
,为什么还需要一个orderBy
?
答: 常规的分页查询中只需要
pageNum/pageSize
即可完成分页的目的,但是往往伴随着分页查询的还有筛选排序,而orderBy
则是专注基于SQL的动态传参排序
4. orderBy
如何使用?会有什么问题吗?
答:
orderBy
和pageNum/pageSize
一样,都是Pagehelper
通过MyBatis
拦截器,在query查询中注入进去的,所以在前端传参时,orderBy
参数应为数据库column desc/asc
这种形式,多字段排序则可以用逗号(,)拼接,譬如:columnA desc,columnB
, 但是另外一方面又存在两个问题, 第一就是大多数数据库表字段设计中,都会使用蛇形case命名,而非常规开发中的驼峰case命名,所以存在一层转换,而这种转换可以分配给前端传参时,也可以分配给后端接参时. 第二就是这样赤裸裸的将排序字段暴露在接口中,会存在order by SQL注入的风险,所以在实际使用过程中,我们需要通过某些手段去校验和排查orderBy
的传参是否合法,譬如用正则表达式匹配参数值只能含有order by
语法中必要的值,例如字段名,desc or asc
,不允许包含特殊字符/数据库关键字等
5. pageNum/pageSize
一定需要给默认值吗?
答: 通过阅读PageHelper源码,我们得知在
Page
查询参数为null时,它并不会赋予它们默认值,并不进行额外的处理,以至于导致分页失败,而给默认值,也是为了谨防前后端调试接口过程中可能会出现的各种意外
3. 源码分析
首先我们看PageHelper.startPage(param)
过程中发生了什么 :
public static Page startPage(Object params) { Page page = PageObjectUtil.getPageFromObject(params, true); Page oldPage = getLocalPage();if (oldPage != null && oldPage.isOrderByOnly()) { page.setOrderBy(oldPage.getOrderBy()); } setLocalPage(page);return page;}
这是
PageHelper
继承(extend)的抽象类PageMethod
中的一个静态方法
再看代码第一行 Page page = PageObjectUtil.getPageFromObject(params, true)
发生了什么:
public static Page getPageFromObject(Object params, boolean required) {if (params == null) {throw new PageException("无法获取分页查询参数!"); } else if (params instanceof IPage) { IPage pageParams = (IPage)params; Page page = null;if (pageParams.getPageNum() != null && pageParams.getPageSize() != null) { page = new Page(pageParams.getPageNum(), pageParams.getPageSize()); }if (StringUtil.isNotEmpty(pageParams.getOrderBy())) {if (page != null) { page.setOrderBy(pageParams.getOrderBy()); } else { page = new Page(); page.setOrderBy(pageParams.getOrderBy()); page.setOrderByOnly(true); } }return page; } else { ... // 此处我只截取了部分代码片段, 以上是较为重要的一块 }}
可以看到在此方法中,会先判断
params
是否为null,再而通过instanceof
判断是否为IPage
的子类或实现类 如果以上两个if/else
皆不满足,则PageHelper
则会在我省略贴出的代码中通过大量的反射代码来获取pageNum/pageSize
以及orderBy
. 总所皆知,反射在Java中虽然广泛应用,并且作为语言独有特性之一,深受广大开发者的喜爱,但是反射在某种程度上,是需要性能成本的,甚至于现阶段很多主流的框架和技术,都在尽量减少反射的运用,以防止框架性能过差,被市场淘汰. 那么到此为止,我们也终于解释并知道了为什么PageParam
要实现IPage
接口了,在此处的代码中可以直接通过接口获取到分页参数,而不需要通过有损性能的反射获取PageHelper
需要的参数
继续看startPage
中的后续代码:
public abstract class PageMethod { protected static final ThreadLocal LOCAL_PAGE = new ThreadLocal();protected static boolean DEFAULT_COUNT = true;public PageMethod() { }protected static void setLocalPage(Page page) { LOCAL_PAGE.set(page); }public static Page getLocalPage() {return (Page)LOCAL_PAGE.get(); } ... ...}
可以看到
PageHelper
继承的抽象类PageMethod
中声明了一个Page
的线程本地变量,而getLocalPage()
则是为了获取当前线程中的Page
而接下来if (oldPage != null && oldPage.isOrderByOnly())
则是判断是否存在旧分页数据 此处的isOrderByOnly
通过getPageFromObject()
函数我们可以知道,当只存在orderBy
参数时,即为true
也就是说,当存在旧分页数据并且旧分页数据只有排序参数时,就将旧分页数据的排序参数列入新分页数据的排序参数 然后将新的分页数据page
存入本地线程变量中 实际应用场景中,这种情况还是比较少,仅排序而不分页,所以某种角度上而言,我们仅当了解便好
接下来再看doSelectPageInfo(ISelect)
中发生了什么:
public PageInfo doSelectPageInfo(ISelect select) { select.doSelect();return this.toPageInfo();}
可以看到,该方法的实现非常简单明了,就是通过注册声明
ISelect
接口由开发自定义集合查询方式并由它内部执行,随后便返回PageInfo
实体 前面我们有提到,PageHelper
基于MyBatis
拦截器达到分页的目的,那么为什么此处的ISelect.doSelect()
执行,就可以返回PageInfo
实体呢? 实际上这便是拦截器的妙用所在,在select.doSelect()
执行时,会触发PageHelper
自定义的MyBatis
查询拦截器,并通过解析SQL和SQL参数,根据数据库类型,进行分页,譬如MySQL的limit
,Oracle的Rownum
等, 同时还会在我们定义的查询SQL之前,PageHelper
会重新生成一条select count(*)的SQL率先执行,已达到它定义Page
内置分页参数的目的
@Intercepts({@Signature( type = Executor.class,method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class}), @Signature(type = Executor.class,method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class, CacheKey.class, BoundSql.class})})public class PageInterceptor implements Interceptor { private volatile Dialect dialect; private String countSuffix = "_COUNT"; protected Cache msCountMap = null;private String default_dialect_class = "com.github.pagehelper.PageHelper";public PageInterceptor() { }public Object intercept(Invocation invocation) throws Throwable { ... ... }}
以上便是PageHelper
内置的自定义MyBatis拦截器,因代码量过多,为了保证不违反本博文文不对题的原则,此处不再做多余讲解,如有需要,我可以另行写一篇博客单独解释并讲解MyBatis拦截器的概念和原理,深度解析MyBatis源码
拓展
PageHelper
不仅有pageNum/pageSize/orderBy
这几个参数,更还有pageSizeZero, reasonable
参数等用以更进阶的分页查询定义,如需更深入的了解,我可以另行写一遍进阶PageHelper使用,此文只作为寻常开发使用讲解
四. 总结
PageHelper作为GitHub上现在近10K的开源分页框架,也许代码深度和广度不及主流市场框架和技术,虽然在功能的实现和原理上,造轮子的难度不高,源码也很清晰,但是在很大程度上解决了很多基于MyBatis的分页技术难题,简化并提示了广大开发者的效率,这才是开发者们在开发的路上应该向往并为之拼搏的方向和道路. 而我们作为受益者,也不应当仅仅是对其进行基本的使用,开发之余,我们也应该关注一些框架的拓展,对框架的底层有一定程度上的了解,并为之拓展和优化
点击加入【技术交流群】
pagehelper工具类_PageHelper最佳实践相关推荐
- Node.js CLI 工具最佳实践
为什么写这篇文章? 一个糟糕的 CLI 工具会让用户觉得难用,而构建一个成功的 CLI 需要密切关注很多细节,同时需要站在用户的角度,创造良好的用户体验.要做到这些特别不容易. 在这个指南中,我列出了 ...
- 2021年的Angular最佳实践
目录 使用Angular CLI 保持最新 严格模式 使用延迟加载 取消订阅RxJS Observables 将ngFor与trackBy一起使用 结论 Angular由Google开发人员使用Typ ...
- Windows Azure 安全最佳实践 - 第 1 部分:深度解析挑战防御对策
我每次与开发人员讨论将应用程序迁移到云时都围绕着两个主要问题. 1. 首先是业务.将应用程序迁移到云可以带来怎样的规模经济? 2. 其次是安全问题."云的安全性如何,尤其是Windows A ...
- Windows Azure 安全最佳实践 - 第 6 部分:Azure 服务如何扩展应用程序安全性
多种 Windows Azure服务可以帮助您将应用程序安全性扩展到云. 有三种服务可提供多个提供程序之间的身份标识映射.内部部署数据中心间的连接和相互发送消息的应用程序功能(无论应用程序位于何处). ...
- java 批量处理 示例_Java异常处理教程(包含示例和最佳实践)
java 批量处理 示例 异常是可能在程序执行期间发生的错误事件,它会破坏其正常流程. Java提供了一种健壮且面向对象的方式来处理异常情况,称为Java异常处理 . 我们将在本教程中研究以下主题. ...
- Java异常处理教程(包含示例和最佳实践)
异常是可能在程序执行期间发生的错误事件,它会破坏其正常流程. Java提供了一种健壮且面向对象的方式来处理异常情况,称为Java异常处理 . 我们将在本教程中研究以下主题. Java异常处理概述 异常 ...
- Windows Azure 安全最佳实践 - 第 4 部分:需要采取的其他措施
那么,哪些安全威胁应由WindowsAzure环境缓解?哪些安全威胁必须由开发人员缓解? 开发 Windows Azure 应用程序的最佳安全做法一文说明了对于在 Windows Azure 中运行的 ...
- Java实现AES工具类(包含CBC和ECB)
目录 一.简介 二.AES工具类 三.实践 3.1 AES之ECB模式加密 3.2 AES之ECB模式解密 3.3 AES之CBC模式加密 3.4 AES之CBC模式解密 结语 一.简介 密码学中 ...
- Java实现MD5工具类
目录 一.简介 二.MD5的特性 三.MD5工具类 四.实践 结语 一.简介 MD5 消息摘要算法是一种广泛使用的哈希函数,具有 128 位哈希值.虽然 MD5 最初被设计为用作加密哈希函数,但已 ...
最新文章
- 更新了朋友圈微博动态,好友何时会点赞评论?
- 高低压验电笔应用口诀及使用方法
- i.e.、e.g.、etc.都是什么英文的缩写?
- JStrom 入门(三) 上传jar文件并启动流程
- [云炬创业管理笔记]第二章成为创业者讨论4
- 跟我一起使用electron搭建一个文件浏览器吧
- 手机号脱敏处理_C#简单代码实现对手机号邮箱等隐私信息进行*号打码
- Python(20)-高级数据类型的公共方法
- springboot项目后台启动jar 和开机启动
- mfc 禁用子菜单_MFC界面开发难上手?BCGControlBar v30.3帮你忙—工具栏和菜单
- php面试题之一——HTML+CSS(基础部分)
- viper4android最新版卡刷包,viper4android fx音效驱动
- CSS选择器 ~ +
- 路由器和交换机简单总结(cisco设备)
- 在线影视网站分享(持续更新)
- 进不去系统rpc服务器不可用,WinXP系统RPC服务器不可用怎么办?
- kaos linux 包管理,KaOS 发布 2018.06 版
- oracle绝对值求和,Oracle存储过程当中经常使用函数
- SpringBoot学习-支持JPA
- 聊聊软件开发的SLAP原则
热门文章
- Python 函数 -next()
- 倍福TwinCAT(贝福Beckhoff)常见问题(FAQ)-如何修改某个轴的数值单位
- Swift 全功能的绘图板开发
- 数据与运算(以及补码)
- 创建一个发布型的空白站点
- leetcode 45 python
- android 方法统计,Android 利用编译时 注入 统计App内所有方法执行时常,分析ANR
- rtt面向对象oopc——0.类、对象及派生
- matlab 变量和数组中,求助:如何将带有符号变量的运算结果储存到数组中
- idea2019打卡没多久就闪退_IDEA 2020.1打开时闪退的问题及解决方法(完美解决方法)...