Spring Boot 集成PageHelper的使用方法
作者：剑圣无痕? 发布时间：2021-10-04 19:16:30
标签：Spring,Boot,集成,PageHelper,用法
前言：
项目中数据分页是一个很常见的需求，目前大部分项目都会使用pagehelper进行分页，那么在使用的过程中是否考虑如下问题？
一、基本集成
引入jar包
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>${pagehelper.version}</version>
</dependency>
Yml配置文件中添加相关配置
pagehelper:
helperDialect: mysql
reasonable: true
supportMethodsArguments: true
params: count=countSql
封装相关分页方法
分页参数类
public class PageParam<T> implements Serializable
{
private static final long serialVersionUID = -7916211163897873899L;
private int pageNum=1;
private int pageSize=10;
//条件参数
private T param;
//排序字段
private String orderBy;
public int getPageSize()
{
return pageSize;
}
public void setPageSize(int pageSize)
{
this.pageSize = pageSize;
}
public int getPageNum()
{
return pageNum;
}
public void setPageNum(int pageNum)
{
this.pageNum = pageNum;
}
public T getParam()
{
return param;
}
public void setParam(T param)
{
this.param = param;
}
public String getOrderBy()
{
return orderBy;
}
public void setOrderBy(String orderBy)
{
//需要注意sql注入
this.orderBy = orderBy;
}
}
分页结果类
public class PagedList<T> implements Serializable
{
private static final long serialVersionUID = -1253790062865437768L;
private int pageNum = 1;
private List<T> data = null;
private int pageCount = 0;
private int recordCount = -1;
private int pagingType = 0;
private int pageSize;
private String orderBy;
/**
* @return the pageSize
*/
public int getPageSize()
{
return pageSize;
}
/**
* @param pageSize
* the pageSize to set
*/
public void setPageSize(int pageSize)
{
if (pageSize <= 0)
{
return;
}
this.pageSize = pageSize;
}
/**
* @return the pageCount
*/
public int getPageCount()
{
return pageCount;
}
/**
* @param pageCount
* the pageCount to set
*/
public void setPageCount(int pageCount)
{
if (pageCount <= 0)
{
return;
}
this.pageCount = pageCount;
}
/**
* @return the recordCount
*/
public int getRecordCount()
{
return recordCount;
}
/**
* @param recordCount
* the recordCount to set
*/
public void setRecordCount(int recordCount)
{
this.recordCount = recordCount;
calcPageCount();
}
private void calcPageCount()
{
if (this.recordCount < 0)
{
return;
}
int tmp = this.recordCount ％ getPageSize();
this.pageCount = (tmp == 0 ? (this.recordCount / getPageSize())
: (this.recordCount / getPageSize() + 1));
if (this.pageNum > this.pageCount && this.pageCount != 0)
{
this.pageNum = this.pageCount;
}
this.pageNum = this.pageCount;
}
public void setData(List<T> data)
{
this.data = data;
if (ObjectUtil.isNotEmpty(data) && this.recordCount == -1)
{
this.recordCount = data.size();
}
}
public List<T> getData()
{
return data;
}
/**
* @return the pagingType
*/
public int getPagingType()
{
return pagingType;
}
/**
* @param pagingType
* the pagingType to set
*/
public void setPagingType(int pagingType)
{
this.pagingType = pagingType;
}
public void setOrderBy(String orderBy)
{
this.orderBy = orderBy;
}
public int getPageNum()
{
return pageNum;
}
public void setPageNum(int pageNum)
{
this.pageNum = pageNum;
}
public String getOrderBy()
{
return orderBy;
}
}
分页工具类
public class PageUtils implements Serializable
{
private static final long serialVersionUID = 377943433889798799L;
public static <T> PagedList<T> exportPagedList(PageParam<T> pageParam)
{
PagedList<T> pl = new PagedList<T>();
// pagesize
int pageSize = pageParam.getPageSize();
if (pageSize <= 0)
{
pageSize = 10;
}
else
{
pl.setPageSize(pageSize);
}
int pageNum = pageParam.getPageNum();
pl.setPageNum(pageNum);
String orderBy= pageParam.getOrderBy();
if(StringUtil.isNotEmpty(orderBy))
{
//防止sql注入
String orderBySql=SQLFilter.sqlInject(orderBy);
pl.setOrderBy(orderBySql);
}
return pl;
}
public static <T>PagedList<T> toPageList(PageInfo<T> spage)
{
PagedList<T> pagedList = new PagedList<T>();
pagedList.setPageSize((int) spage.getPageSize());
pagedList.setPageNum((int) spage.getPageNum());
pagedList.setRecordCount((int) spage.getTotal());
pagedList.setData(spage.getList());
pagedList.setPageCount((int) spage.getPages());
return pagedList;
}
}
示例代码
@PostMapping("getPageList")
public Result getPageList(@RequestBody PageParam<TUser> pageParm)
{
//接收参数
PagedList<TUser> pl =PageUtils.exportPagedList(pageParm);
return Result.success(userService.queryPageList(pl, pageParm.getParam()));
}
public PagedList<TUser> queryPageList(PagedList<TUser> page,TUser user)
{
PageInfo<TUser> pageInfo= PageHelper.startPage(page).doSelectPageInfo(()-> list(user));
//转换结果
return PageUtils.toPageList(pageInfo);
}
前段传入参数
{
"pageSize":10,
"pageNum":"1",
//查询条件
"param":{
"name":"张三210001"
},
//排序字段
"orderBy":"age desc"
}
执行结果
2022-04-15 22:26:39.914 [http-nio-9090-exec-9] DEBUG [613920d89eb54bfd8601c93ec8572dcf] c.s.f.m.UserMapper.queryPageList - ==> Preparing: SELECT * FROM t_user u LEFT JOIN t_user_role ur ON ur.userOid = u.oid WHERE name = ? order by age desc LIMIT ?
2022-04-15 22:26:39.919 [http-nio-9090-exec-9] DEBUG [613920d89eb54bfd8601c93ec8572dcf] c.s.f.m.UserMapper.queryPageList - ==> Parameters: 张三210001(String), 10(Integer)
2022-04-15 22:26:40.267 [http-nio-9090-exec-9] DEBUG [613920d89eb54bfd8601c93ec8572dcf] c.s.f.m.UserMapper.queryPageList - <== Total: 1
基础的分页查询已经发完成了，下面解答上面的问题的方法
二、分页中的排序字段如何防止SQL注入问题
对于前段传入的排序字段，我们需要进行SQL过滤处理，关于这个问题其实在上述的分页封装类中已经进行了解决
示例代码：
public class SQLFilter
{
public static String sqlInject(String str)
{
if (StringUtil.isBlank(str))
{
return null;
}
// 去掉'|"|;|\字符
str = StringUtil.replace(str, "'", "");
str = StringUtil.replace(str, "\"", "");
str = StringUtil.replace(str, ";", "");
str = StringUtil.replace(str, "\\", "");
// 转换成小写
str = str.toLowerCase();
// 非法字符
String[] keywords = { "master", "truncate", "insert", "select",
"delete", "update", "declare", "alert", "drop" };
// 判断是否包含非法字符
for (String keyword : keywords)
{
if (str.indexOf(keyword) != -1)
{
throw new SysException("包含非法字符");
}
}
return str;
}
}
三、复杂的SQL分页语句
复杂的SQL分页语句，需要自定义SQL的count语句如何实现呢？
PageHelper实现分页，默认是查询自定义的count语句是否存在，如果存在就用自定义的语句，否则就在外层包装查询的语句，而自定义count语句只需要在在查询语句名称后面添加_COUNT即可。例如
查询集合的语句名称为queryPageList，那么查询count的语句为queryPageList_COUNT，返回Long类型即可。
<select id="queryPageList_COUNT" resultType="java.lang.Long">
select count(1) from t_user u
left join t_user_role ur on ur.userOid=u.oid
<where>
<if test="name != null">name=#{name}</if>
</where>
</select>
四、分页失效的常见的场景有哪些？
1.pageHelper分页查询有个特殊的要求，查询下sql语句一定要紧跟在分页查询的后面，否则分页查询会失效。之前采用的如下写法容易失效，建议采用java8的写法
PageHelper.startPage(pagedList.getPageNum(),pagedList.getPageSize());
//紧跟分页查询后面
List<TUser> list = list(user);
PageInfo<TUser> pageInfo =new PageInfo<>(list);
return PageUtils.toPageList(pageInfo);
2.注意pagehelper的reasonable 默认为false，遇到查询页数大于总页数时，出现分页失败
pagehelper的reasonable 默认为false，遇到查询页数大于总页数时，查询为空；当reasonable设置为true时，遇到查询页数大于总页数时，查询最后一页数据；
3.PageHelper先开启分页，后对list数据操作将会导致分页错误
示例代码：
public PageInfo<TUserVO> getUserPageList(int pageNum, int pageSize) {
PageHelper.startPage(pageNum,pageSize);
List<TUserVO> tUserVOsByView = userMapper.getUserList();
List<TUserVO> TUserVOs = new ArrayList<>();
for (TUserVO TUserVO : tUserVOsByView) {
TUserVO TUserVOSingle = new TUserVO();
TUserVOSingle.setHdId(TUserVO.getHdId());
TUserVOs.add(TUserVOSingle);
}
PageInfo<TUserVO> pageViewInfo = new PageInfo<>(TUserVOs);
return pageViewInfo;
}
4.PageHelper先对list数据操作，后开启分页，将会导致分页失效
示例代码：
public PageInfo<TUserVO> getUserPageList(int pageNum, int pageSize) {
List<TUserVO> tUserVOsByView = userMapper.getUserList();
List<TUserVO> TUserVOs = new ArrayList<>();
for (TUserVO TUserVO : tUserVOsByView) {
TUserVO TUserVOSingle = new TUserVO();
TUserVOSingle.setHdId(TUserVO.getHdId());
}
PageHelper.startPage(pageNo,pageSize);
PageInfo<TUserVO> pageViewInfo = new PageInfo<>(TUserVOs);
return pageViewInfo;
}
大家需要注意下，抽时间可以去验证下结果。
五、大表数据PageHelper分页性能如何
PageHelper 对于大表查询数据量越大，性能越差，这是因为PageHelper分页是自动在sql语句后面拼接limit没有进行相关的优化，一旦数据大，性能就比较慢。
例如：
优化前SQL语句：
SELECT d.* FROM tag_detail d LIMIT 10000000,10
查询的时间大概需要10秒左右，执行速度比较慢。
优化后SQL语句：
SELECT d.* FROM tag_detail d
INNER JOIN
(SELECT oid FROM tag_detail LIMIT 10000000,10) t
ON d.oid= t.oid;
子查询先通过分页查询主键字段，然后进行关联查询，经过优化后，查询时间大概为1秒左右。性能大幅度提升。
总结：
本文讲解了PageHelper的基本的使用和相关的问题，这些都是我从实际的项目中总结出来的问题以及相关的解决方案，大家在使用的时候要特别注意，不要放同样的错误。
来源：https://juejin.cn/post/7086854293080260639
0
投稿猜你喜欢
- Spring在Java EE开发中是实际意义上的标准,但我们在开发Spring的时候可能会遇到以下令人头疼的问题:(1)大量配置文件的定义;
Canvas绘制文本时，使用FontMetrics对象，计算位置的坐标。public static class FontMetrics {- Android WebView或手机浏览器打开连接问题解决办法总结1.通常情况下 大家可能都想使用WebView打开网页内部链接而不想再调用
- 项目里头需要做一个判断用户输入的号码是否是正确的手机号码，正确的手机号码应该是11位的，这里我们需要用一个正则表达式来进行判断，
- Android当道，现在学习Android开发还晚吗？写下这个问题的时间是–2014年6月15号，我会回答：不晚，Android至少还能在活
- 很不错的手电筒APP，分享给大家，希望大家喜欢。1. Java代码 package com.
- 前言在讲述线程池的前提 先补充一下连接池的定义连接池是创建和管理一个连接的缓冲池的技术，这些连接准备好被任何需要它们的线程使用可以看到其连接
- 本文实例讲述了C#图像处理之头发检测的方法。分享给大家供大家参考。具体如下：//发色检测（YCbCr颜色空间）public Bitmap H
- 同步客户端套接字示例 下面的示例程序创建一个连接到服务器的客户端。该客户端是用同步套接字生成的，因此挂起客户端应用程
- 在远程调用中，需要把参数和返回值通过网络传输，这个使用
- 在Java中，泛型的引入是为了在编译时提供强类型检查和支持泛型编程。为了实现泛型，Java编译器应用类型擦除实现： &
- 题目要求：两人比赛，A,B，每人最开始分得6张手牌，手牌大小为从1到9 A先出牌，B后出牌，若出牌在桌面上存在，在出牌人获得两张相同牌中间的
- 本文实例讲述了Android编程自定义菜单实现方法。分享给大家供大家参考，具体如下：在android开发的过程中系统自带的菜单往往满足不了开
- using System;using System.Collections.Generic;using System.Text;using
- 在看KMP算法时,想要简单的统计一下执行时间和性能。得出的结论是： Java的String的indexOf方法性能最好，其次是KMP算法，其
- 以下代码为一个工具类package com.imooc.reflect;import java.lang.reflect.Method;pu
- 1.图集导航1.1 为什么对包名的命名要有所规范呢！使用规范的命名有益于程序的开发和后期阅读通俗的说：就是自己写的代码别人也能看的懂，代码结
- 本文以实例形式介绍了基于Java实现的Dijkstra算法，相信对于读者研究学习数据结构域算法有一定的帮助。Dijkstra提出按各顶点与源
- PS：本文包含了大部分strings函数的说明，并附带举例说明。本来想自己整理一下的，发现已经有前辈整理过了，就转了过来。修改了原文一些源码
- 一般而言，在传统的VB6中父子窗体（诸如“闪屏”窗体是“父窗体”加载内容，然后启动自动关闭，启动主窗体，是子窗体）的交互中，我们只需按照这样
