解决若依的分页失效问题

解决若依的分页失效问题

我的迷茫和胆怯也一直都在，但我告诉自己，就算是万丈深渊，走下去，也是前程万里。——木心《素履之往》

首先，我们根据若依的文档来清楚几个问题：

• 前端采用基于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;
    }
}

这段代码是一个用于手动实现数据分页的方法。下面是它的基本原理解释：

1. PageDomain pageDomain = TableSupport.buildPageRequest();: 通过调用TableSupport.buildPageRequest()方法获取当前的分页信息，包括页码和每页显示的条目数。

2. Integer pageNum = pageDomain.getPageNum(); Integer pageSize = pageDomain.getPageSize();: 从分页信息中获取当前页码和每页显示的条目数。

3. TableDataInfo rspData = new TableDataInfo();: 创建一个TableDataInfo对象，用于存储分页后的数据。

4. rspData.setCode(HttpStatus.SUCCESS);: 设置响应状态码为成功状态。

5. rspData.setRows(...): 通过Java Stream API进行分页操作。使用list.stream()将列表转换为流，然后使用skip跳过前面的元素，使用limit限制元素数量，最后使用collect将结果收集为一个新的List，作为当前页的数据。

6. rspData.setTotal(list.size());: 将总条目数设置为列表中元素的总数，不考虑分页。

7. 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参数被错误的使用。