SpringBoot中mybatis分页插件的使用--【pagehelper组件】

SpringBoot系列文章目录

SpringBoot知识范围-学习步骤【JSB系列之000】

本系列校训

用免费公开视频，卷飞培训班哈人！打死不报班，赚钱靠狠干！
只要自己有电脑，前后项目都能搞！N年苦学无人问，一朝成名天下知！

SpringBoot技术很多很多

本文专指mybatis分页，可以是SSM的项目，也可以是springBoot 的项目里的mybatis,或者mybatis plus

韩顺平说：学习JAVA的人有两大难
第一困惑，JAVA能百度到的知识太多太多，完全不知道学啥
第二困惑，就是不知道以什么样的顺序去学，有的时候乱看一堆视频有遗漏，有的时候，两边的视频还有重复。
Spring的外围技术就更多了。其实，分页插件就是其中之一。

所以，学习东西要系统一些，如果基本功不够，那后面的技术就会学的很浮。

环境及工具：

本系列环境

环境	win11
工具	idea 2017/idea 2018
jdk	1.8
数据库	mysql5.5
maven	3.2.1
项目导入方式	maven 导入
数据库前端工具	mysql-front (navicat 也可以)

数据库前端工具：mysql-front (navicat 也可以)
主要是这些跟PHPStudy 2018 整合了，所以有的时候懒的打开navicat
关于环境的重要性，直接看上面的《SpringBoot 的项目编译即报错处理–JSB系列之001》

上效果图

不管是啥系统，信息都不太可能一页就显示完成，这个时间就需要列表，还有分页。事实上连微信小程序也是要分页的，只是它的翻页是手拉屏幕向上的时候，屏幕有一个转圈的小动作，然后，下一页的内容就出来。不过，现在讲的是服务端的代码

现在的系统分页主要就是这么三种情况
1 数据都推动前端，用JS分页。
2 把数据集查出来，JAVA代码分页
3 在数据库里只查那一页的数据。

一、使用前端表格插件进行分页
有很多的table 页面组件都支持这种。

• 特别特别适合于字典类的数据。
  -优点也是特别明显，就是根本就不用你考虑，把全部的数据集往 前面一扔就行了。JS都是组件写好的，
  例如用bootstrap的拓展table组件，JS的这样的table 有不少
  优点：实现简单，直接设置前端table组件的参数即可。
  缺点：从其实现原理上即可看出，这个数据是用户请求一次，服务器会将该表的所有数据返回到前端，刷新界面和点击下一页的操作的时候都会重复以上操作。显示数据的速度会因为网络带宽、服务器压力等而变慢。
  所以，这种方式不能用于业务数据，那完全就是灾难
  JSTable是一个灵活的、强大的动态表格插件，HTML表互动与排序、过滤和分页功能。灵感来自Vanilla-DataTables和datatable jQuery插件。基础调用new JSTable。
  layui 也有这种分页表格。
  甚至就是现在主流的VUE也有这种表格vue + el-table +Print.js 实现前端打印分页多页表格。
  要特别注意的是，当这个字典表的记录很少（小于1000）的时候，这种一次性全查出来，并不会引起性能的下降，反而这种效率还最高。
  这主要就是因为这种表一般都会被优化。要么放在缓存里，要么就用alter table cache将字典直接放入内存。

如果建表或是修改表时指定了Cache子句，则当用户第一次访问表中的数据是，这个表将被加入到数据库高速缓存中并保留较长一段时间，
如果建表或是修改表时指定了Cache子句，则当用户第一次访问表中的数据是，这个表将被加入到数据库高速缓存中并保留较长一段时间，这样用户以后再次访问该表是，可直接访问数据库高速缓存中的数据，从而提高访问的速度。
因此建议对一些较小的，，用户访问频繁的表，可以考虑加上cache子句，以提高访问效率。常见如用户表，权限表，角色表，部门表等。
修改表的语句示例为：
alter table TB_SYS_USER cache;
alter table TB_SYS_USER_dept cache;
alter table TB_SYS_USER_role cache;

所以千万学了一个半桶水的固定思维说，现在都是SQL分页了，前台分页这种早就淘汰等等。
二、后端用代码实现分页
用JAVA代码来切分list

就是根据当前第几页，每页显示几条数据进行分页数据的处理。

优点：无，应该说是为了学员的练习吧。不各道为啥这样，跟前端分页比，有代码量，跟SQL分页比，它速度也没快。
一次请求只会向前端返回一页的数据，浏览器需要接收的数据变少了，页面展示会变快

缺点：前台页面分页的缺点，SQL分页的缺点它都有了。
如果强说一个优点，那就是不用管啥数据库，这样对于一些老项目还是有独到的地方

三、数据库用sql语句实现
以MySQL为例， select * from sys_order limit 0,10 //从第0条开始查，一共查询10条记录
优点：真正实现了从数据库就是分页处理
也是业务表最主流的分页技术。
甚至还有了oracle 分页语句，sqlserver 分页语句的不少讨论
oracle

SELECT * FROM (
SELECT t.*, ROWNUM RN
FROM (SELECT * FROM table_name ORDER BY column_name ASC) t
WHERE ROWNUM <= :page * :size
)
WHERE RN > (:page - 1) * :size;

SQLSEVER

select * from 
(
  select ROW_NUMBER()over(order by StuNo asc) id,*  from  Student
)Student
where id between @startIndex and @endIndex

目前流行的mybatis分页插件

插件1 Mybatis-plus

插件2 pagehelper
要说明的是，并不是 springBoot 项目里存在的这两种插件，事实上，在mybatis 的时候，就一直存在。
比如在SSM的项目中。
在mybatis的pom中添加分页插件依赖

<dependency>
<groupId>com.github.pagehelper</groupId>  
<artifactId>pagehelper</artifactId>
<version>5.2.0</version> //版本号
</dependency>

在mybatis-config.xml中创建分页插件

<plugins>
<!--分页插件-->
<plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
</plugins>

在查询的JAVA语句中：

   @Test
    public void selectPageTest() {
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);//获取映射方法
        Page<Object> objects = PageHelper.startPage(1, 6);       //创建分页插件对象
        List<Emp> list = mapper.selectByExample(null);           //查询对象
        list.forEach(System.out::println);
        System.out.println(objects);
    }

在Spring Boot里使用pagehelper

第一步那肯定就是pom的引入了。

 <!--  mybatis分页插件-->
        <!--导入pagehelper相关依赖-->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper</artifactId>
            <version>5.1.2</version>
        </dependency>

在项目的配置文件 里

配置类。这里可以参见《SpringBoot 的配置类–JSB系列之003》

这里一定要把这个知识点弄懂，还有就是配置类的运行顺序。

package com.code;

import com.baomidou.mybatisplus.plugins.PaginationInterceptor;
import com.baomidou.mybatisplus.plugins.PerformanceInterceptor;
import com.github.pagehelper.PageHelper;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.transaction.annotation.EnableTransactionManagement;

import java.io.IOException;
import java.util.Properties;


//mybatis 分页插件 参数配置

@Configuration
@EnableTransactionManagement
@MapperScan("com.code.mapper")
public class PageHelperConfig {
    @Bean
    public PaginationInterceptor paginationInterceptor() {
        PaginationInterceptor page = new PaginationInterceptor();
        page.setDialectType("mysql");
        return page;
    }

    @Bean
    public PerformanceInterceptor performanceInterceptor() {
        PerformanceInterceptor page = new PerformanceInterceptor();
        page.setFormat(true);
        return page;
    }

    //配置mybatis的分页插件pageHelper
    @Bean
    public PageHelper pageHelper(){
        PageHelper pageHelper = new PageHelper();
        Properties properties = new Properties();
        properties.setProperty("offsetAsPageNum","true");
        properties.setProperty("rowBoundsWithCount","true");
        properties.setProperty("reasonable","true");
        properties.setProperty("dialect","mysql");    //配置mysql数据库的方言
        pageHelper.setProperties(properties);
        return pageHelper;
    }

}

比较贴心的是PaginationInterceptor 这个类是插件带的

JAVA查询列表时

 /**
     * @param keyword  搜索关键词
     * @param p        页面            默认第1页
     * @param pageSize 每页显示条数 默认每页10条
     * @param model
     * @return
     */
    @RequestMapping("/list") //分页查询数据
    public String list(String keyword, Integer p, Integer pageSize, Model model) {

        p = null == p ? 1 : p; //默认显示第一页
        pageSize = null == pageSize ? 10 : pageSize; //默认每页显示10条
        Page<Userinfo> sortPage = new Page<Userinfo>(p, pageSize);//参数一是当前页，参数二是每页个数
        List<Userinfo> userinfoList = userinfoMapper.selectPage(sortPage, null);
        long total = sortPage.getTotal(); //总页数
        int current = sortPage.getCurrent();
        long pages = sortPage.getPages();
        model.addAttribute("userinfoList", userinfoList);   //绑定接受参数
        model.addAttribute("cp", current);   //当前页
        model.addAttribute("tp", pages);   //总页数
        model.addAttribute("total", total);   //总条数
        model.addAttribute("pageListURL", "userinfo/list");   //总条数
        return "userinfo/userinfoList";
    }

页面上的使用

<%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="UTF-8" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn" %>
<%--分页代码--%>
<%--项目绝对路径--%>
<c:set var="ctx" value="${pageContext.request.contextPath}"/>
<div style="text-align: center">
    <div class="layui-btn-group">
        <a href="${ctx}/${pageListURL}?p=1" class="layui-btn layui-btn-primary layui-btn-sm">首页</a>
        <c:if test="${cp>1}">
            <a href="${ctx}/${pageListURL}?p=${cp-1}"
               class="layui-btn layui-btn-primary layui-btn-sm">上一页</a>
        </c:if>
        <%--前后各显示3个页码--%>
        <c:forEach begin="${cp-3>1?cp-3:1}" end="${cp+3<tp?cp+3:tp}" var="k">
            <c:if test="${cp==k}">  <%-- 是当前页--%>
                <a href="${ctx}/${pageListURL}?p=${k}" class="layui-btn  layui-btn-sm">${k}</a>
            </c:if>
            <c:if test="${cp!=k}"> <%-- 不是当前页--%>
                <a href="${ctx}/${pageListURL}?p=${k}"
                   class="layui-btn layui-btn-primary layui-btn-sm">${k}</a>
            </c:if>
        </c:forEach>

        <c:if test="${cp<tp}">
            <a href="${ctx}/${pageListURL}?p=${cp+1}"
               class="layui-btn layui-btn-primary layui-btn-sm">下一页</a>
        </c:if>
        <a href="${ctx}/${pageListURL}?p=${tp}" class="layui-btn layui-btn-primary layui-btn-sm">尾页</a>
        <button class="layui-btn layui-btn-primary layui-btn-sm">共${total}条记录</button>
    </div>
</div>

从页面代码就可以看出，pagehelper的功能还是挺强大

还要注意的是

如果项目里使用了shiro 的话，一定要把 验证码的URL放出来，不然的话，你的验证码的路径被你自己的shiro 敌我不分的胡乱杀掉了。
这里就不详细说了，这个知识点涉及的问题比较多。

/**
	 * 配置shiro的过滤器
	 */
	@Bean(SHIRO_FILTER)
	public ShiroFilterFactoryBean shiroFilterFactoryBean(SecurityManager securityManager) {
		ShiroFilterFactoryBean factoryBean = new ShiroFilterFactoryBean();
		// 设置安全管理器
		factoryBean.setSecurityManager(securityManager);
		// 设置未登陆的时要跳转的页面
		factoryBean.setLoginUrl(loginUrl);
		Map<String, String> filterChainDefinitionMap = new HashMap<>();
		// 设置放行的路径
		if (anonUrls != null && anonUrls.length > 0) {
			for (String anon : anonUrls) {
				filterChainDefinitionMap.put(anon, "anon");
			}
		}
		filterChainDefinitionMap.put("/static/**", "anon"); // 先把页面全放行了，不然调 试起来太麻烦了 ，by项目花园范德彪
		filterChainDefinitionMap.put("/code/**", "anon"); //这里要注意的是把验证码的URL放出来，不然不会显示到登陆上。by项目花园范德彪
		
		// 设置登出的路径
		if (null != logOutUrl) {
			filterChainDefinitionMap.put(logOutUrl, "logout");
		}
		// 设置拦截的路径
		if (authcUlrs != null && authcUlrs.length > 0) {
			for (String authc : authcUlrs) {
				filterChainDefinitionMap.put(authc, "authc");
			}
		}
		Map<String, Filter> filters=new HashMap<>();
//		filters.put("authc", new ShiroLoginFilter());
		//配置过滤器
		factoryBean.setFilters(filters);
		factoryBean.setFilterChainDefinitionMap(filterChainDefinitionMap);
		return factoryBean;
	}

成功之后就可以展示出效果图的样子了。

配置文件设置

项目目录，不能有中文或空格，就乖乖的用C语言能识别的变量名是最好的

#运行端口号
server.port=8889
#配置项目路径
server.servlet.context-path=
#数据库连接配置信息  Ctrl+/ 注释
#mysql8驱动
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
#mysql5驱动   记得把连接地址换成本机ip地址
#spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/jsbperson_db?characterEncoding=utf-8&useSSL=false&serverTimezone=GMT
spring.datasource.username=root
spring.datasource.password=123456
#mybatis配置
mybatis.type-aliases-package=com.code.entity
#mybatis.mapper-locations=classpath*:mapper/*.xml
mybatis-plus.mapper-locations=classpath*:mapper/*.xml
#jsp视图解析器
spring.mvc.view.prefix=/view/
spring.mvc.view.suffix=.jsp
#文件上传的配置
spring.servlet.multipart.max-file-size=120MB
spring.servlet.multipart.max-request-size=120MB
#开启日志调试
#logging.level.root=debug
#显示mybatis日志
logging.level.com.code.mapper=debug

要注意的是启动的端口号，
数据源里的datasource 的名字。用户名，密码。还有就是mysql 的驱动是com.mysql.jdbc.Driver
总的来说，
com.mysql.jdbc.Driver 是 mysql-connector-java 5.5之前的，
com.mysql.cj.jdbc.Driver 是 mysql-connector-java 6及6之后的的，
初学者容易陷入一个误区，就是什么东西最新版是最好的，事实上很有可能他写的东西，明明JDK6.0就完全足够。一边喊着自己的机器内存不足，一边让内存运行着他自己用不到的东西。就比如说idea应该算是这些开发者工具里最卡的。有人可能明明只是打开几个网页，那为什么不使用webstorm? 甚至不是写很多代码的时候，为什么不选择更轻量级的VSCode?

配套资源

SpringBoot中mybatis分页插件的使用–【pagehelper组件】
https://download.csdn.net/download/dearmite/88136248

作业：

无，看懂即是神
范德彪经典语录： 学pagehelper，你不能按套路出牌