《程序猿入职必会(10) · SpringBoot3 整合 MyBatis-Plus》-LMLPHP

写在前面的话

本系列博文已连载到第10篇,在前几篇文章基础上,我们已经得到了一个完整的前后端项目,并且后端已经接入了MyBatis 完成了教师表的 CURD 操作,本篇文章在此基础上,整合MyBatis-Plus,从而进一步强化功能。

关联文章:
《程序猿入职必会(1) · 搭建拥有数据交互的 SpringBoot 》
《程序猿入职必会(2) · 搭建具备前端展示效果的 Vue》
《程序猿入职必会(3) · SpringBoot 各层功能完善 》
《程序猿入职必会(4) · Vue 完成 CURD 案例 》
《程序猿入职必会(5) · CURD 页面细节规范 》
《程序猿入职必会(6) · 返回结果统一封装》
《程序猿入职必会(7) · 前端请求工具封装》
《程序猿入职必会(8) · 整合 Knife4j 接口文档》
《程序猿入职必会(9) · 用代码生成器快速开发》


MyBatis-Plus

技术简介

MyBatis-Plus(简称 MP)是一个 MyBatis 的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。
更详细的内容介绍,建议直接看官网,这边不展开赘述,直接上实操,下文简称为“MP”。


整合步骤

**Step1、引入依赖 **

<!-- 整合MyBatis-Plus -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
    <version>3.5.5</version>
</dependency>

<!-- 整合MyBatis -->
<!--<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>3.0.3</version>
</dependency>-->

引入MyBatis-Plus相关依赖,这里有两个注意事项:
1、这里要引入适配SpringBoot3的版本,而不是mybatis-plus-boot-starter。这里的 mybatis-plus-spring-boot3-starter 是专门为 Spring Boot 3.x 版本设计的启动器,支持 Spring Boot 3.x 的特性和依赖。而 mybatis-plus-boot-starter 通常是为较早版本的 Spring Boot(如 2.x)设计的启动器。

2、MyBatis-Plus 的依赖包含了 MyBatis 的,这里建议把后者的依赖注释,除非你可以保障两者的版本一致,否则可能会引发一系列意想不到的问题。

Step2、修改配置
和 MP 相关的配置,无非就是 datasource 和 Mybatis,在之前的基础上,只需要将属性 mybatis 改成 mybatis-plus,其他都不需要调整。

mybatis-plus:
  mapper-locations: classpath:/mappings/**/*Mapper.xml
  type-aliases-package: com.lw.sbdemo2.entity
  config-location: classpath:mybatis-config.xml

Step3、修改实体类
这里只需要添加一个 @TableId 注解,标识一下主键即可(这里由于主键字段不是id,所以需要加注解)。
其他都是表和字段,由于也是基于表生成的代码,遵循约定大于配置原则,可以不需要调整。
正常情况使用 @TableField 标识字段,@TableName 标识表名,自动支持驼峰转下划线。

public class ZyTeacherInfo {

    @TableId
    @Schema(description = "教师编号")
    @NotBlank(message = "教师编号不能为空")
    private java.lang.String teaCode;

    @Schema(description = "教师名称")
    @Size(min = 2, max = 8, message = "教师名称长度需在2-8位")
    private java.lang.String teaName;

    ...省略其他代码
}

对应表信息:
《程序猿入职必会(10) · SpringBoot3 整合 MyBatis-Plus》-LMLPHP

Step4、修改 Mapper
这里直接选择新建一个 Mapper,以示区别,因为旧的 Mapper 已经有继承一个自己封装的基类了。
创建一个 Mapper 接口,继承 MP 的BaseMapper,如下所示:

package com.lw.sbdemo2.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.lw.sbdemo2.entity.ZyTeacherInfo;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface ZyTeacherInfoMpMapper extends BaseMapper<ZyTeacherInfo> {
    
}

Step5、编写测试 Controller
这里先临时写一个接口,这里只为测试,正常不直接注入Mapper。

@Autowired
private ZyTeacherInfoMpMapper zyTeacherInfoMpMapper;

@GetMapping("")
public List<ZyTeacherInfo> findList(ZyTeacherInfo zyTeacherInfo) {
    QueryWrapper<ZyTeacherInfo> queryWrapper = new QueryWrapper<>();
    queryWrapper.eq("tea_name", zyTeacherInfo.getTeaName());
    List<ZyTeacherInfo> zyTeacherInfos = zyTeacherInfoMpMapper.selectList(queryWrapper);
    for (ZyTeacherInfo teacherInfo : zyTeacherInfos) {
        System.out.println(teacherInfo);
    }
    return zyTeacherInfos;
}

启动程序,用 Knife4j 测试一下效果,如下所示。
《程序猿入职必会(10) · SpringBoot3 整合 MyBatis-Plus》-LMLPHP
效果还可以,至此,基础整合工作算完成了。


功能改造

之前 MyBatis 的版本实现了 CURD 的完整功能,那整合完 MP 之后,也不能落下。
使用前面的 ZyTeacherInfoMpMapper,已经可以实现大部分的功能,它提供的方法可不少。
但总不能在 Controller 层,直接操作 Mapper 吧,而且一些操作毕竟还是要组装 QueryWrapper 等实现,不够清爽。
那就把常用的方法,封装到业务 Service 类里面即可。
这里上一段示例代码:

@Slf4j
@Service
public class ZyTeacherInfoMpService extends ServiceImpl<ZyTeacherInfoMpMapper, ZyTeacherInfo> {

    /**
     * 插入用户
     */
    public void addUser(ZyTeacherInfo user) {
        this.save(user);
    }

    /**
     * 删除用户
     */
    public void deleteUser(Long id) {
        this.removeById(id);
    }

    /**
     * 更新用户
     */
    public void updateUser(ZyTeacherInfo user) {
        this.updateById(user);
    }

    /**
     * 根据ID查询用户
     */
    public ZyTeacherInfo getUserById(Long id) {
        return this.getById(id);
    }

    /**
     * 查询所有用户
     */
    public List<ZyTeacherInfo> getAllUsers() {
        return this.list();
    }

    /**
     * 根据条件查询用户(LambdaQueryWrapper方式)
     */
    public List<ZyTeacherInfo> getUsersByName(String name) {
        LambdaQueryWrapper<ZyTeacherInfo> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(ZyTeacherInfo::getTeaName, name);
        return this.list(queryWrapper);
    }

    /**
     * 更新电话(LambdaUpdateWrapper方式)
     */
    public void updateUserPhone(Long userId, String phone) {
        LambdaUpdateWrapper<ZyTeacherInfo> updateWrapper = new LambdaUpdateWrapper<>();
        updateWrapper.eq(ZyTeacherInfo::getTeaCode, userId)
                .set(ZyTeacherInfo::getTeaPhone, phone);
        this.getBaseMapper()
                .update(null, updateWrapper);
    }
}

可以看到了选择多样化,更复杂的一些场景,可以借助 LambdaQueryWrapper 和 LambdaUpdateWrapper 实现。
上面只是部分示例,并不是完整代码,同时实战时,框架层面可以考虑进一步的封装。


过程复盘

可以看到,整个过程相当丝滑,大部分操作 MP 都提供了 Service 和 Mapper 层的基类,主要是去除了 SQL-XML。
虽然都是代码生成器生成的,但还是减少不少代码量,最主要是操作数据更贴近了程序猿的思维。
当然,一些复杂的多表查询,或者想提升SQL的性能,那还是继续选择 XML 的方式较为合适。
MP 允许无缝使用 MyBatis 原有的功能,两者并不冲突。


LambdaQueryWrapper

LambdaQueryWrapper 是 MyBatis-Plus 提供的一个非常强大的查询构造器,它允许你以 Lambda 表达式的方式构建查询条件。以下是一些复杂场景的示例,展示如何使用 LambdaQueryWrapper 进行多条件查询、组合条件、排序等操作。
假设我们有一个 User 实体,包含字段 name、age 和 email。

1、多条件查询
我们想要查询年龄大于 18 且名字包含 “John” 的用户。

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper
    .gt(User::getAge, 18) // 年龄大于 18
    .like(User::getName, "John"); // 名字包含 "John"

List<User> users = userService.list(queryWrapper);

2、组合条件查询
假设我们想要查询年龄在 20 到 30 之间的用户,并且邮箱不为空。

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper
    .between(User::getAge, 20, 30) // 年龄在 20 到 30 之间
    .isNotNull(User::getEmail); // 邮箱不为空

List<User> users = userService.list(queryWrapper);

3、使用 OR 条件
假设我们想要查询名字为 “Alice” 或者年龄小于 25 的用户。

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper
    .gt(User::getAge, 18) // 年龄大于 18
    .like(User::getName, "John"); // 名字包含 "John"

List<User> users = userService.list(queryWrapper);

4、排序和分页
假设我们想要查询所有用户,按照年龄降序排列,并且只获取前 10 条记录。

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper
    .orderByDesc(User::getAge) // 按照年龄降序排列
    .last("LIMIT 10"); // 只获取前 10 条记录

List<User> users = userService.list(queryWrapper);

5、复杂的嵌套条件
假设我们想要查询年龄大于 18 且(名字包含 “John” 或者邮箱以 “@example.com” 结尾的用户)。

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper
    .gt(User::getAge, 18) // 年龄大于 18
    .and(wrapper -> wrapper // 嵌套条件
        .like(User::getName, "John")
        .or()
        .likeRight(User::getEmail, "@example.com")); // 邮箱以 "@example.com" 结尾

List<User> users = userService.list(queryWrapper);

6、动态条件查询
在某些情况下,查询条件可能是动态的。假设我们有一个查询条件对象,用户可以选择性地输入查询条件。

public List<User> dynamicQuery(UserQueryDTO queryDTO) {
    LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
    
    if (queryDTO.getName() != null) {
        queryWrapper.like(User::getName, queryDTO.getName());
    }
    if (queryDTO.getAge() != null) {
        queryWrapper.eq(User::getAge, queryDTO.getAge());
    }
    if (queryDTO.getEmail() != null) {
        queryWrapper.eq(User::getEmail, queryDTO.getEmail());
    }
    
    return userService.list(queryWrapper);
}

LambdaQueryWrapper 提供了灵活的方式来构建复杂的查询条件,支持多种操作,如条件组合、排序、分页等。通过使用 Lambda 表达式,可以避免硬编码字段名,从而提高代码的可读性和安全性。


总结陈词

此篇文章介绍了MyBatis-Plus 的基础整合过程,整体还是挺好用的,推荐,仅供学习参考。
简单列了一下实战,关于 MP 还有很多基础和扩展用法,可以自行掌握,加油!
💗 后续会逐步分享企业实际开发中的实战经验,有需要交流的可以联系博主。

《程序猿入职必会(10) · SpringBoot3 整合 MyBatis-Plus》-LMLPHP

08-11 09:21