MyBatis-Plus分页查询IPage的使用方法,如何自定义分页查询功能?

目录

1. MyBatis-Plus 分页插件介绍

2. 准备工作-创建项目配置环境

2.1 创建数据库表Product商品表

2.2 创建Maven项目,创建包,接口,类

2.3 添加MyBatisPlus依赖和 Lombok 插件

2.4 编写 Configuration 分页插件配置文件

2.5 编写 application.properties 配置文件 

2.6 实体类代码,接口代码

3. IPage 分页的使用方式

4. 自定义分页查询

5. QueryWrapper 条件构造器的使用


1. MyBatis-Plus 分页插件介绍

(1)MyBatis-Plus 自带有分页插件功能,能够帮助我们在查询的时候自动实现分页功能,并返回给我们详细的分页相关数据;

(2)使用了分页插件之后,我们在编写 xxxMapper.xml SQL语句文件语句时,就不需要在SQL语句中自己手动书写分页关键字,分页插件会自动帮助我们添加;

(3)下面我创建一个小demo帮助小白同学书写项目代码,这里是为小白入门准备的入门环境配置,如果是老手复习 Page 的使用方式,可直接跳过配置环境流程;

2. 准备工作-创建项目配置环境

2.1 创建数据库表Product商品表

执行如下SQL语句,生成Product商品表如下图

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for product
-- ----------------------------
DROP TABLE IF EXISTS `product`;
CREATE TABLE `product`  (
  `id` int NOT NULL,
  `name` varchar(255) CHARACTER SET utf8mb3 COLLATE utf8mb3_unicode_ci NULL DEFAULT NULL,
  `price` decimal(10, 2) NULL DEFAULT NULL,
  `color` varchar(255) CHARACTER SET utf8mb3 COLLATE utf8mb3_unicode_ci NULL DEFAULT NULL,
  `production_date` datetime NULL DEFAULT NULL,
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB CHARACTER SET = utf8mb3 COLLATE = utf8mb3_unicode_ci ROW_FORMAT = Dynamic;

-- ----------------------------
-- Records of product
-- ----------------------------
INSERT INTO `product` VALUES (1, 'HuaWei P30', 6800.00, 'red', '2024-04-08 21:57:26');
INSERT INTO `product` VALUES (2, 'IPhone 10', 8800.00, 'blue', '2024-04-27 21:57:31');
INSERT INTO `product` VALUES (3, 'IPad Pro', 5800.00, 'black', '2024-06-20 21:57:35');
INSERT INTO `product` VALUES (4, 'XiaoMi 10', 3800.00, 'purple', '2024-04-01 21:57:42');
INSERT INTO `product` VALUES (5, 'Vivo 20', 5800.00, 'white', '2024-04-30 21:57:48');
INSERT INTO `product` VALUES (6, 'HuaWei MatePad11', 2600.00, 'white', '2024-04-04 16:40:19');
INSERT INTO `product` VALUES (7, 'IPhone 20 ProMax', 11000.00, 'red', '2024-04-29 16:41:07');
INSERT INTO `product` VALUES (8, 'Red Mi K60', 3100.00, 'purple', '2024-04-14 16:41:43');
INSERT INTO `product` VALUES (9, 'HuaWei Mate 40', 5999.00, 'blue', '2024-04-17 10:20:14');
INSERT INTO `product` VALUES (10, 'HuaWei Mate 60 Pro', 6999.00, 'purple', '2024-04-03 10:21:18');


SET FOREIGN_KEY_CHECKS = 1;

2.2 创建Maven项目,创建包,接口,类

项目结构如下所示,

config包:存放Configuration配置类;

controller包:存放Controler层类;

entity包:存放数据库实体映射类;

mapper包:存放数据库访问接口Interface;

service包:存放业务层接口Interface;

impl包:存放service层接口实现类;

resource:存放项目properties文件,bootstrap文件,mapper.xml 配置文件;

2.3 添加MyBatisPlus依赖和 Lombok 插件

想要使用MyBatisPlus分页插件,首先要添加依赖,如下

Lombok 插件非必须,是我在项目中展示会用到,方便实体类的书写;

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.1</version>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.22</version>
            <scope>compile</scope>
        </dependency>
2.4 编写 Configuration 分页插件配置文件

使用分页插件功能,第二步就是配置分页插件拦截器,在工作时不需要我们配置,项目中肯定是已经配好的,这里我们自己动手书写小demo,就简单做一下配置

// Configuration 注释标注当前类是一个Spring Boot配置类,项目在启动时自动读取加载配置文件中我们定义的Bean对象
@Configuration
// MapperScam 定义实体类的扫描路径,在本项目中路径为 "com.haust.mapper"
@MapperScan("com.haust.mapper")
public class MyBatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor(){
        // 创建一个拦截器对象,
        MybatisPlusInterceptor mybatisPlusInterceptor = new MybatisPlusInterceptor();
        /**
         * 我们将 new 一个分页插件拦截器 PaginationInnerInterceptor 参数为数据库类型 MySQL,当然也可以写其他数据库类型,根据自己的数据库类型而定
         * 然后将此拦截器add添加到拦截器对象中即可生效
         * (这里演示MyBatis-Plus分页插件拦截器,其实还可以继续添加其他拦截器,我们可以继续 new ,继续add添加到拦截器对象中哦!)
         */
        mybatisPlusInterceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return mybatisPlusInterceptor;
    }
}
2.5 编写 application.properties 配置文件 

MySQL驱动为5.7的,driver-class-name为"com.mysql.jdbc.Driver";

MySQL驱动为8.0以上的,driver-class-name为"com.mysql.cj.jdbc.Driver";多了一个 cj

用户名密码自行更改

spring.datasource.driver-class-name = com.mysql.cj.jdbc.Driver
spring.datasource.url = jdbc:mysql://localhost:3306/patent?useUnicode=true&characterEncoding=utf-8&tinyInt1isBit=false&useSSL=false&serverTimezone=Asia/Shanghai
spring.datasource.username = root
spring.datasource.password = 123456
2.6 实体类代码,接口代码

Product 实体类代码

// @Data Lombok插件提供的注释,方便实体类的书写,
// 只要注释在当前实体类,会自动为我们生成Getter,Setter,toString,equals,hashCode方法
@Data
// @TableName("product")指定对应的数据库表名 product
@TableName("product")
public class Product {
    // @TableId("id") 指定数据主键为 id
    @TableId("id")
    private Long id;

    // @TableField("name") 标注当前String字段 name 对应product表中的字段name,下方同理
    @TableField("name")
    private String name;

    @TableField("price")
    private Double price;

    @TableField("color")
    private String color;

    @TableField("production_date")
    private Date productionDate;
}

ProductMapper 接口代码如下

// @Mapper 注释标注当前类为数据访问层接口
@Mapper
// 继承BaseMapper接口,泛型为 Product 实体类
public interface ProductMapper extends BaseMapper<Product> {
}

ProductService 接口代码

@Service
// ProductService接口继承MyBatisplus提供的现有接口IService,并填写泛型为Product
public interface ProductService extends IService<Product> {
}

ProductServiceImpl 业务层接口实现类方法

// 实现类继承MyBatisPlus提供的ServiceImpl业务层实现类,
// 泛型有两个,第一个是Mapper接口,第二个是Mapper对应的实体类
// 只要继承了ServiceImpl,就不需要重写IService中的方法了,因为继承的ServiceImpl类中已经帮我们重写过了
public class ProductServiceImpl extends ServiceImpl<ProductMapper, Product> implements ProductService {
}

3. IPage 分页的使用方式

IPage 是MyBatis-Plus 提供的一个分页相关的接口,它有一个实现类为 Page,类中定义了分页相关的多个参数,还有一点需要记住,Page 对象既作为分页查询的条件参数,也是分页查询的结果接收参数,这一点在下方代码中会有所体现;

size (每页显示条数):此参数通常由前端传给我们,然后再封装到Page对象中进行分页查询;

current (要展示哪一页数据):此参数通常由前端传给我们,然后再封装到Page对象中进行分页查询;

orders(排序规则):按照哪些字段进行排序?可以为多个,例如希望通过时间进行排序,如果时间相同就根据用户ID降序排序,可以添加多个字段;

total (总记录数):指查询完毕后返回的数据库中总记录数,注意不包含已被逻辑删除的数据;

records(查询到的分页结果集数据):分页查询得到的多条数据会存储在 records 中,可以看出该对象是一个集合,可以传递一个泛型,反省就是查询到的数据对应的实体泛型;

还有其它的参数,但上面四个最为常用,简单说一下

public class Page<T> implements IPage<T> {
    private static final long serialVersionUID = 8545996863226528798L;
    protected List<T> records;
    protected long total;
    protected long size;
    protected long current;
    protected List<OrderItem> orders;
    protected boolean optimizeCountSql;
    protected boolean searchCount;
    protected boolean optimizeJoinOfCountSql;
    protected String countId;
    protected Long maxLimit;

Page对象使用方式如下代码 

@SpringBootTest
public class ProductMapperTest {
    // 自动注入 productMapper 接口对应的实现类对象
    @Autowired
    private ProductMapper productMapper;
    @Test
    public void testPageQuery(){
        // 创建分页查询相关参数 page,泛型为 Product,表示查询到的结果对应的实体类为Product
        Page<Product> page = new Page<>();
        // 设置分页查询显示第二页的数据,实际开发过程中该参数有前端传递
        page.setCurrent(2);
        // 设置分页查询每页显示四条数据,实际开发过程中该参数有前端传递
        page.setSize(4);
        // 创建排序字段集合,不想排序不加即可,实际开发过程中一般都会要求按照时间降序排序
        List<OrderItem> orders = new ArrayList<>();
        // 按照价格排序,排序方式为降序,ASC为True表示升序,false表示降序,第一个参数表示数据库中的列名
        orders.add(new OrderItem("price",false));
        // 按照生产时间排序,排序方式为降序
        orders.add(new OrderItem("production_date",false));
        // 将排序对象集合加入分页查询对象Page中
        page.setOrders(orders);
        // 执行分页查询,可以创建一个Page对象接受查询结果,
        // 也可以用查询条件参数page,但其实最后结果都是同一个
        page = productMapper.selectPage(page, null);
// 可以新创建一个Page对象,就像下面这样
        Page<Product> productPage = productMapper.selectPage(page,null);
        // 输出分页查询结果显示当前的哪一页
        System.out.println(page.getCurrent());
        // 输出分页查询结果的总数据条数
        System.out.println(page.getTotal());
        // 输出分页查询结果的数据集合
        System.out.println(page.getRecords());
        // 输出分页查询结果的每页显示条数
        System.out.println(page.getSize());
// 判断刚才分页查询的两个结果对象是否为同一个
        System.out.println(page == productPage);
// 输出第一个分页查询对象内存地址
        System.out.println(page);
        // 输出第二个分页查询对象内存地址
        System.out.println(productPage);
    }
}

运行测试类,在控制台可以看到输出结果,我将其复制到下面

// 此处2表示当前显示第二页的数据,就是我们传入的参数current
2

// 此处10表示数据库中一共查询到十条记录,不包含逻辑删除的数据
10 

// 下方表示分页查询到的四条数据,排序规则就是按照时间降序进行排序的
Product {
	id = 9, name = 'HuaWei Mate 40', price = 5999.0, color = 'blue', productionDate = Wed Apr 17 10: 20: 14 CST 2024
}, 
Product {
	id = 3, name = 'IPad Pro', price = 5800.0, color = 'black', productionDate = Thu Jun 20 21: 57: 35 CST 2024
}, 
Product {
	id = 5, name = 'Vivo 20', price = 5800.0, color = 'white', productionDate = Tue Apr 30 21: 57: 48 CST 2024
}, 
Product {
	id = 6, name = 'HuaWei MatePad11', price = 3800.0, color = 'white', productionDate = Thu Apr 04 16: 40: 19 CST 2024
}

// 4表示当前页显示4条数据,就是我们传入的参数 size
4

4. 自定义分页查询

自定义分页查询也不难实现,首先再 xxxMapper 类中定义接口方法

最重要的一点!!! 使用Page实现自定义分页查询,Page参数对象必须位于参数列表的第一个位置,否则会失效,一定一定要记住放在参数列表的第一个位置。

public interface ProductMapper extends BaseMapper<Product> {

    // 自定义一个分页查询接口,通过Product实体传参,使用 @Param 注释标注参数名称
    // 最重要的一点!!! 使用Page实现分页查询,Page参数对象必须位于参数列表的第一个位置,否则会失效
    Page<Product> selectPageByColor(@Param("page") Page<Product> page,
                                    @Param("product") Product product);
}

编写 selectPageByColor 接口方法的测试类 

@Test
    public void testPageQueryByColor(){
        // 创建分页查询相关参数 page,泛型为 Product,表示查询到的结果对应的实体类为Product
        Page<Product> page = new Page<>();
        // 设置分页查询显示第二页的数据
        page.setCurrent(1);
        // 设置分页查询每页显示四条数据
        page.setSize(2);
        // 创建排序字段集合,如果不想排序不加即可
        List<OrderItem> orders = new ArrayList<>();
        // 按照价格排序,排序方式为降序,ASC为True表示
        orders.add(new OrderItem("price",false));
        // 将排序对象集合加入分页查询对象Page中
        page.setOrders(orders);
        Product product = new Product();
        product.setColor("purple");
        // 执行分页查询
        page = productMapper.selectPageByColor(page, product);
        // 输出分页查询结果的数据集合
        System.out.println(page.getRecords());
        // 输出分页查询结果的总数据条数
        System.out.println(page.getTotal());
    }

运行此方法,控制台得到查询结果

// 分页查询获取到两条结果,并且是按照价格降序排序,颜色都为purple,符合查询预期
[Product {
	id = 10, name = 'HuaWei Mate 60 Pro', price = 6999.0, color = 'purple', productionDate = Wed Apr 03 10: 21: 18 CST 2024
}, Product {
	id = 4, name = 'XiaoMi 10', price = 3800.0, color = 'purple', productionDate = Mon Apr 01 21: 57: 42 CST 2024
}]

// 3表示一共有三条数据,但我们只显示了第一页的两条数据
3

 

5. QueryWrapper 条件构造器的使用

细心的小伙伴或许已经注意到了,在第一个测试方法中,MyBatis-Plus 提供的 分页查询方法 selectPage 需要传递两个参数,

第一个是分页查询对象Page,第二个其实是查询条件,可以看到它是 Wrapper 类型的,Wrapper 是一个接口,它有一个实现类 LambdaQueryWrapper,通过这个 LambdaQueryWrapper,我们就可以在对象中添加我们查询数据是的过滤条件,不需要再 mapper.xml 配置文件中再去自定义书写MP中没有提供的查询接口;

LambdaQueryWrapper 的使用方式也不难,首先创建一个LambdaQueryWrapper对象,就可以通过 . 的方式链式调用,方法也是见名知意,

between 就是数据库中的 between...and...

orderByDesc 就是数据库中的降序排序

orderByAsc 就是数据库中的升序排序

数据库中的查询条件这里都有,都可以说是见名知意

括号内传递约束的数据库字段,通过 xxx(实体类名)::getxxx 的方式获取即可

例如要获取Product商品表的主键ID,写法就是 Product::getId

@Test
    public void testPageQueryByCondition(){
        Page<Product> page = new Page<>();
        page.setCurrent(1);
        page.setSize(2);
        LambdaQueryWrapper<Product> wrapper = new LambdaQueryWrapper<>();
        // 查询ID在 1~5 之间的商品数据,再将它们按照价格降序排序,若价格相同,再将它们按照生产日期升序排序
        wrapper.between(Product::getId, 1, 5)
                .orderByDesc(Product::getPrice)
                .orderByAsc(Product::getProductionDate);
        productMapper.selectPage(page,wrapper);
        System.out.println(page.getRecords());
    }

写法极其简单,只有有条件,就一直通过 . 的方式进行链式添加,添加完毕后,将 wrapper 对象做法查询条件传递给查询接口就可以了,执行上述代码,在控制台中查询到三条数据,

我给它粘贴出来方便查看,可以看到三条数据按照价格降序排序,与预期结果一致,完美!!!

[
 Product{id=2, name='IPhone 10', price=8800.0, color='blue', productionDate=Sat Apr 27 21:57:31 CST 2024},
 Product{id=1, name='HuaWei P30', price=6800.0, color='red', productionDate=Mon Apr 08 21:57:26 CST 2024}, 
 Product{id=5, name='Vivo 20', price=5800.0, color='white', productionDate=Tue Apr 30 21:57:48 CST 2024}
]

相关推荐

  1. MyBatis-Plus查询

    2024-04-20 16:06:05       45 阅读
  2. SpringBoot使用mybatis-plus查询无效解决方案

    2024-04-20 16:06:05       47 阅读
  3. MyBatis-Plus实现定义SQL语句查询

    2024-04-20 16:06:05       47 阅读
  4. MyBatis可以如何实现查询

    2024-04-20 16:06:05       15 阅读
  5. 使用Mybatis-plus查询Total与实际条数不对应

    2024-04-20 16:06:05       41 阅读
  6. mybatis&Mysql 查询

    2024-04-20 16:06:05       39 阅读
  7. 查询到List后再进行mybatis-plus

    2024-04-20 16:06:05       30 阅读

最近更新

  1. TCP协议是安全的吗?

    2024-04-20 16:06:05       18 阅读
  2. 阿里云服务器执行yum,一直下载docker-ce-stable失败

    2024-04-20 16:06:05       19 阅读
  3. 【Python教程】压缩PDF文件大小

    2024-04-20 16:06:05       18 阅读
  4. 通过文章id递归查询所有评论(xml)

    2024-04-20 16:06:05       20 阅读

热门阅读

  1. 【GitHub免密拉取代码】

    2024-04-20 16:06:05       12 阅读
  2. hadoop大数据原理与应用------初识Hadoop数据集

    2024-04-20 16:06:05       15 阅读
  3. 微服务架构中的业务可监控设计

    2024-04-20 16:06:05       13 阅读
  4. MyBatis-知识点详解

    2024-04-20 16:06:05       13 阅读
  5. vue3+vite+superMap(超图)实现通视分析

    2024-04-20 16:06:05       11 阅读
  6. 295. 数据流的中位数

    2024-04-20 16:06:05       13 阅读