WHCSRL 技术网

Mybatis基础学习之数据分页的简单使用

前言

小伙伴们,大家好,我是狂奔の蜗牛rz,当然你们可以叫我蜗牛君,我是一个学习Java半年多时间的小菜鸟,同时还有一个伟大的梦想,那就是有朝一日,成为一个优秀的Java架构师。

这个Mybatis基础学习系列是用来记录我学习Mybatis框架基础知识的全过程 (这个系列是参照B站狂神的Mybatis最新教程来写的,由于是之前整理的,但当时没有发布出来,所以有些地方可能有错误,希望大家能够及时指正!)


之后我将尽量以两天一更的速度更新这个系列,还没有学习Mybatis3框架的小伙伴可以参照我的博客学习一下;当然学习过的小伙伴,也可以顺便跟我一起复习一下基础。最后,希望能够和大家一同进步吧!加油吧!少年们!

特别提醒:如果对Mybatis基础学习系列感兴趣,可以阅读本系列往期博客:
第一篇Mybatis基础学习之初识Mybatis
第二篇Mybatis基础学习之第一个Mybatis程序
第三篇Mybatis基础学习之CRUD增删改查
第四篇Mybatis基础学习之万能的Map和模糊查询
第五篇Mybatis基础学习之配置解析(上篇)
第六篇Mybatis基础学习之配置解析(下篇)
第七篇Mybatis基础学习之使用ResultMap解决字段名不一致
第八篇Mybatis基础学习之日志工厂的简单使用


今天我们来到了Mybatis基础学习的第八站:数据分页的简单使用。废话不多说,让我们开始今天的学习内容吧。

8.数据分页的简单使用

为什么要实现数据分页

缓解数据库压力,给人的体验更好 (例如瀑布流,搜索图片就是使用了瀑布流,拖不到底,一般不建议这样做,资源加载太占用内存)

8.1 搭建基本环境

8.1.1 编写测试数据库

1.创建数据库和用户表

-- 创建Mybatis数据库
Create Database `MyBatis`;

-- 使用Mybatis数据库
Use `MyBatis`;

-- 创建User用户表
Create table `User`(
	`id` int(10) not null primary key,
    `name` varchar(30) default null,
    `pwd` varchar(30) default null
)engine=InnoDB default charset=utf8;
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

2.插入用户测试信息

-- 插入用户信息
Insert into `User`(`id`,`name`,`pwd`) values
(1,'周杰伦','zjl123456'),
(2,'方文山','fws123456'),
(3,'黄俊郎','hjl123456')
  • 1
  • 2
  • 3
  • 4
  • 5

8.1.2 创建基本项目

1.创建基本项目

1-1 创建普通Maven项目
  • 创建一个普通的Maven项目,不勾选任何选项
1-2 编写项目基本信息
  • 设置项目名称和选择项目存放位置,以及GrouId和ArtifactId等信息

2.导入相关的资源依赖

2-1 导入MySQL驱动的资源依赖
<!-- mysql数据库驱动 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.47</version>
</dependency>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
2-2 导入Mybatis的资源依赖
<!-- mybatis框架资源依赖 -->
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.2</version>
</dependency>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
2-3 导入junit的资源依赖
<!-- junit单元测试资源依赖 -->
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
2-4 导入log4j的资源依赖
<!-- 引入log4j的资源依赖-->
<!-- https://mvnrepository.com/artifact/log4j/log4j -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
2-5 项目整体的资源依赖
<!-- 导入依赖 -->
<dependencies>
    <!-- mysql数据库驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.47</version>
    </dependency>
    <!-- mybatis框架资源依赖 -->
    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.2</version>
    </dependency>
    <!-- junit单元测试资源依赖 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
    <!-- 引入log4j的资源依赖-->
    <!-- https://mvnrepository.com/artifact/log4j/log4j -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
</dependencies>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29

3. 在build中配置resources

  • 在当前Maven项目的pom.xml文件中添加如下配置
<!-- 在build中配置resources,来防止我们资源导出失败的问题 -->
<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>false</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>false</filtering>
        </resource>
    </resources>
</build>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21

8.1.3 编写Mybatis的核心配置文件

1. 编写 db.properties 配置文件
  • resources文件目录下创建db.properties配置文件并编写其内容
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
pwd=123456
  • 1
  • 2
  • 3
  • 4

2. 编写 mybatis-config.xml 配置文件

  • resources文件目录下创建mybatis-config.xml配置文件并编写其内容
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<!-- configuration: 核心配置文件 -->
<configuration>
    
    <!-- 引入外部配置文件(优先使用外部配置文件) -->
    <properties resource="db.properties"/>
    
    <!-- 设置Log4j标准日志输出 -->
    <settings>
        <setting name="logImpl" value="LOG4J"/>
    </settings>
    
    <!-- 通过给包起别名 -->
    <typeAliases>
        <package name="com.kuang.pojo"/>
    </typeAliases>  
    
    <!-- 设置默认环境为开发环境 -->
    <environments default="development">
        <!-- 设置一道环境为开发环境 -->
        <environment id="development">
            <!-- transactionManager: 表示事务管理器 (MyBatis的默认管理器是JDBC) -->
            <transactionManager type="JDBC"/>
            <!-- dataSource: 表示数据源, 主要作用: 连接数据库 (注意: MyBatis的默认数据源类型是POOLED,也就是有池的连接) -->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${pwd}"/>
            </dataSource>
        </environment>
    </environments>
    
    <!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
    
</configuration>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42

8.1.4 编写User实体类和MybatisUtils工具类

1. 编写User实体类
package com.kuang.pojo;

// User用户实体类
public class User {

    private int id; // 编号
    private String name; // 用户名
    private String password; // 密码

    // User实体类的无参构造方法
    public User() {
    }

    // User实体类的有参构造方法
    public User(int id, String name, String password) {
        this.id = id;
        this.name = name;
        this.password = password;
    }

    /**
     * 生成对应的get和set方法
     */
    
    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    // toString方法
    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + ''' +
                ", password='" + password + ''' +
                '}';
    }
    
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59

2. 编写MybatisUtils工具类

package com.kuang.utils;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

/**
 * Mybatis工具类
 * SqlSessionFactoryBuilder (建造工厂)
 * --> sqlSessionFactory (生产sqlSession)
 * --> sqlSession
 */
public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;

    // 静态方法体
    static {
        try {
            // 读取配置文件
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            // 获取工厂
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * SqlSession提供了在数据库执行SQL命令所需的所有方法
     */
    public static SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }

}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41

8.1.5 编写UserMapper接口和UserMapper.xml映射文件

1.编写UserMapper接口

package com.kuang.dao;

// UserMapper接口
public interface UserMapper {

}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

2.编写UserMapper.xml映射文件

<?xml version="1.0" encoding="UTF-8" ?>
        <!DOCTYPE mapper
                PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
                "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.kuang.dao.UserMapper">

       <!-- 结果集映射: id对应select标签中的resultMap,type对应Java实体类 -->
    <resultMap id="UserMap" type="User">
        <!-- column: 数据库中的字段,property: Java实体类中的属性 (只需要显式定义不一致的字段和属性即可) -->
<!--        <result column="id" property="id"/>
        <result column="name" property="name"/>-->
        <result column="pwd" property="password"/>
    </resultMap>

</mapper>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15

到这里,项目基本环境就搭建完毕了,接下来就是如何在Mybatis中实现分页

Mbatis中,我们可以使用MySQL的limit进行分页,也可以使用RowBounds进行分页,当然还可以使用PageHelper插件来实现分页,这里我们主要学习前两种方式!

8.2 使用limit实现分页

Mybatis中使用limit分页前,想必很多小伙伴可能已经忘记MySQL数据库的limit语法,因此我们先来复习一下基本的limit语法

8.2.1 limit分页语法

基本语法

Select * from user limit startIndex,pageSize;
  • 1

我们可以发现,关键字limit后面有两个参数,分别是startIndexpageSize,其中startIndex表示起始位置下标,而pageSize表示页面大小,而startIndex的计算方式(n-1) * pageSize

8.2.2 使用SQL语句实现分页

1.分页测试一

1-1 编写查询SQL语句
-- 每页显示2个,从第0个(指下标)开始查
Select * from user limit 0,2;
  • 1
  • 2
1-2 查看查询结果

在这里插入图片描述

2.分页测试二

2-1 编写查询SQL语句
-- 每页显示2个,从第3个开始查
Select * from user limit 2,2;
  • 1
  • 2
2-2 查看查询结果

在这里插入图片描述

3.分页测试三

3-1 编写查询SQL语句
-- 每页显示3个,默认从第0个开始查
-- [0,n):左闭右开,返回n条数据
Select * from user limit 3;
  • 1
  • 2
  • 3
3-2 查看查询结果

在这里插入图片描述

8.2.3 在MyBatis中使用limit分页

1.修改UserMapper接口

package com.kuang.dao;

import com.kuang.pojo.User;
import java.util.List;
import java.util.Map;

// UserMapper接口
public interface UserMapper {
    
    // 使用limit分页查询用户信息
    List<User> getUserByLimit(Map<String,Integer> map);
    
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13

2.修改UserMapper.xml映射文件

<?xml version="1.0" encoding="UTF-8" ?>
        <!DOCTYPE mapper
                PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
                "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.kuang.dao.UserMapper">
    
   <!-- 结果集映射: id对应select标签中的resultMap,type对应Java实体类 -->
    <resultMap id="UserMap" type="User">
        <!-- column: 数据库中的字段,property: Java实体类中的属性 (只需要显式定义不一致的字段和属性即可) -->
<!--        <result column="id" property="id"/>
        <result column="name" property="name"/>-->
        <result column="pwd" property="password"/>
    </resultMap>

    <!-- 查询语句: 分页查询用户信息 -->
    <select id="getUserByLimit" parameterType="map" resultMap="UserMap">
        select * from mybatis.user limit #{startIndex},#{pageSize}
    </select>

</mapper>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20

3.编写UserMapperTest测试类

package com.kuang.dao;

import com.kuang.pojo.User;
import com.kuang.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.HashMap;
import java.util.List;

public class UserMapperTest {    
    
	@Test
    // limit分页查询用户信息
    public void getUserByLimit() {
        // 获取sqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        // 获取mapper接口类
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        // 获取map对象
        HashMap<String,Integer> map = new HashMap<String,Integer>();
        // 设置参数:从下标0(第1个)开始查,每页2个
        map.put("startIndex",0);
        map.put("pageSize",2);
        // 遍历数组
        List<User> userList = mapper.getUserByLimit(map);
        for (User user : userList) {
            System.out.println(user);
        }
        // 关闭sqlSession
        sqlSession.close();
    }
    
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33

4.查看测试结果

在这里插入图片描述

结果查询到user表中的前两条数据!

8.3 使用RowBounds实现分页

1.修改UserMapper接口

package com.kuang.dao;

import com.kuang.pojo.User;
import java.util.List;

// UserMapper接口
public interface UserMapper {
    
    // 使用RowBounds实现分页查询用户信息
    List<User> getUserByRowBounds();
    
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

2.修改UserMapper配置文件

<?xml version="1.0" encoding="UTF-8" ?>
        <!DOCTYPE mapper
                PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
                "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.kuang.dao.UserMapper">
    
       <!-- 结果集映射: id对应select标签中的resultMap,type对应Java实体类 -->
    <resultMap id="UserMap" type="User">
        <!-- column: 数据库中的字段,property: Java实体类中的属性 (只需要显式定义不一致的字段和属性即可) -->
<!--        <result column="id" property="id"/>
        <result column="name" property="name"/>-->
        <result column="pwd" property="password"/>
    </resultMap>

    <!--查询语句:RowBounds分页查询用户信息-->
    <select id="getUserByRowBounds"  resultMap="UserMap">
        select * from mybatis.user
    </select>
</mapper>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19

3.编写UserMapperTest测试类

package com.kuang.dao;

import com.kuang.pojo.User;
import com.kuang.utils.MybatisUtils;
import org.apache.ibatis.session.RowBounds;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;

public class UserMapperTest {   
    
    @Test
    public void getUserByRowBounds() {
        // 获取SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        // RowBounds实现分页:从下标1(第2个)开始查,每页2个
        RowBounds rowBounds = new RowBounds(1,2);
        // 通过Java代码层面实现分页
        List<User> userList = sqlSession.selectList("com.kuang.dao.UserMapper.getUserByRowBounds",null,rowBounds);
        // 遍历数组
        for (User user : userList) {
            System.out.println(user);
        }
        // 关闭sqlSession
        sqlSession.close();
    }
    
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28

4.测试结果

在这里插入图片描述

结果成功查询到user表中的第二条和第三条数据!

8.4 MyBatis分页插件

这里推荐一款好用的Mybatis的分页插件PageHelper,了解PageHelper分页插件即可,万一项目需要使用,要知道它是什么。感兴趣的小伙伴可以去PageHelper的官网学习,这里就不再详细介绍了!

分页插件PageHelper官网

PageHelper官网首页

在这里插入图片描述


好了,今天的有关 数据分页的简单使用 的学习就到此结束啦。欢迎小伙伴们积极学习和讨论,喜欢的可以给蜗牛君点个关注,顺便来个一键三连。我们下期见,拜拜啦!


参考视频链接【狂神说Java】Mybatis最新完整教程IDEA版通俗易懂

推荐阅读