解决若依的分页失效问题
我的迷茫和胆怯也一直都在,但我告诉自己,就算是万丈深渊,走下去,也是前程万里。——木心《素履之往》
首先,我们根据若依的文档来清楚几个问题:
- 前端采用基于
bootstrap
的轻量级表格插件bootstrap-table(opens new window) - 后端采用基于
mybatis
的轻量级分页插件pageHelper
基本使用
@PostMapping("/list")
@ResponseBody
public TableDataInfo list(User user)
{
startPage(); // 此方法配合前端完成自动分页
List<User> list = userService.selectUserList(user);
return getDataTable(list);
}
常见坑点1:selectPostById
莫名其妙的分页。例如下面这段代码
startPage();
List<User> list;
if(user != null){
list = userService.selectUserList(user);
} else {
list = new ArrayList<User>();
}
Post post = postService.selectPostById(1L);
return getDataTable(list);
原因分析:这种情况下由于user
存在null
的情况,就会导致pageHelper
生产了一个分页参数,但是没有被消费,这个参数就会一直保留在这个线程上。 当这个线程再次被使用时,就可能导致不该分页的方法去消费这个分页参数,这就产生了莫名其妙的分页。
上面这个代码,应该写成下面这个样子才能保证安全。
List<User> list;
if(user != null){
startPage();
list = userService.selectUserList(user);
} else {
list = new ArrayList<User>();
}
Post post = postService.selectPostById(1L);
return getDataTable(list);
常见坑点2:添加了startPage
方法。也没有正常分页。例如下面这段代码
startPage();
Post post = postService.selectPostById(1L);
List<User> list = userService.selectUserList(user);
return getDataTable(list);
原因分析:只对该语句以后的第一个查询(Select)
语句得到的数据进行分页。
上面这个代码,应该写成下面这个样子才能正常分页。
Post post = postService.selectPostById(1L);
startPage();
List<User> list = userService.selectUserList(user);
return getDataTable(list);
常见坑点3:业务层有一大堆的数据处理,导致数据错乱,startPage
彻底失效
其实,已经描述的很清楚了,就是无论怎么使用startPage
,也都无法实现,那么,我们这种方法就可以绝对解决该问题:
首先,我们创建一个方法类,其实就是对于Pagehelper
的二次封装
package com.ruoyi.utils;
import com.ruoyi.common.constant.HttpStatus;
import com.ruoyi.common.core.page.PageDomain;
import com.ruoyi.common.core.page.TableDataInfo;
import com.ruoyi.common.core.page.TableSupport;
import java.util.List;
import java.util.stream.Collectors;
public class ManualPagination {
public static TableDataInfo pagination(List<?> list) {
// 数据手动分页
PageDomain pageDomain = TableSupport.buildPageRequest();
Integer pageNum = pageDomain.getPageNum();
Integer pageSize = pageDomain.getPageSize();
TableDataInfo rspData = new TableDataInfo();
rspData.setCode(HttpStatus.SUCCESS);
rspData.setRows(
list.stream().skip((long) (pageNum - 1) * pageSize)
.limit(pageSize)
.collect(Collectors.toList()));
rspData.setTotal(list.size());
return rspData;
}
}
这段代码是一个用于手动实现数据分页的方法。下面是它的基本原理解释:
-
PageDomain pageDomain = TableSupport.buildPageRequest();
: 通过调用TableSupport.buildPageRequest()
方法获取当前的分页信息,包括页码和每页显示的条目数。 -
Integer pageNum = pageDomain.getPageNum(); Integer pageSize = pageDomain.getPageSize();
: 从分页信息中获取当前页码和每页显示的条目数。 -
TableDataInfo rspData = new TableDataInfo();
: 创建一个TableDataInfo
对象,用于存储分页后的数据。 -
rspData.setCode(HttpStatus.SUCCESS);
: 设置响应状态码为成功状态。 -
rspData.setRows(...)
: 通过Java Stream API进行分页操作。使用list.stream()
将列表转换为流,然后使用skip
跳过前面的元素,使用limit
限制元素数量,最后使用collect
将结果收集为一个新的List,作为当前页的数据。 -
rspData.setTotal(list.size());
: 将总条目数设置为列表中元素的总数,不考虑分页。 -
return rspData;
: 返回包含分页数据的TableDataInfo
对象。
总体来说,该方法通过手动处理列表,根据当前页码和每页显示的条目数,从原始列表中截取出相应的数据,然后将这部分数据和总条目数封装到TableDataInfo
对象中进行返回。
然后控制层如何使用呢,我们也做一个代码演示:
@PostMapping("/list")
@ResponseBody
public TableDataInfo list(User user)
{
List<User> list = userService.selectUserList(user);
//手动分页
return ManualPagination.pagination(list);
}
提示
项目分页插件默认是
Mysql
语法,如果项目改为其他数据库需修改配置application.yml
文件中的属性helperDialect: 你的数据库
注意
只要你可以保证在
PageHelper
方法调用后紧跟MyBatis
查询方法,这就是安全的。因为PageHelper
在finally
代码段中自动清除了ThreadLocal
存储的对象。 如果代码在进入Executor
前发生异常,就会导致线程不可用,这属于人为的Bug
(例如接口方法和XML
中的不匹配,导致找不到MappedStatement
时),这种情况由于线程不可用,也不会导致ThreadLocal
参数被错误的使用。