MyBatis-Plus 是 MyBatis 的增强工具，旨在简化开发并提高效率。内容涵盖入门步骤，包括 Spring Boot 依赖引入与数据库配置。详细解析核心注解 @TableName、@TableField 和@TableId 在实体类映射中的应用。介绍条件构造器 QueryWrapper、UpdateWrapper 及其 Lambda 版本的使用场景与链式调用方法。最后阐述自定义 SQL 的实现，支持注解方式与 XML 映射文件结合 Wrapper 进行复杂查询。
MyBatis-Plus(简称 MP) 是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。
特性
支持数据库 PostgreSQL, MySQL, MariaDB, Oracle, SQL Server, OceanBase, H2, DB2… (任何能使用 MyBatis 进行增删改查，并且支持标准 SQL 的数据库应该都在 MyBatis-Plus 的支持范围内)
官网地址：Mybatis-Plus 简化开发
Mybatis-Plus 操作数据库的步骤:
Spring Boot2 依赖：
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.7</version>
</dependency>
Spring Boot3 依赖：
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-spring-boot3-starter</artifactId>
<version>3.5.5</version>
</dependency>
MySQL 依赖：
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<scope>runtime</scope>
</dependency>
配置数据库（application.yml 文件）：
# 数据库连接配置
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/mybatis_test?characterEncoding=utf8&useSSL=false
username: root
password: root
driver-class-name: com.mysql.cj.jdbc.Driver
配置数据库（application.properties 文件）：
#驱动类名称
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
#数据库连接的 url
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/mybatis_test?characterEncoding=utf8&useSSL=false
#连接数据库的用户名
spring.datasource.username=root
#连接数据库的密码
spring.datasource.password=root
MybatisPlus 提供了一个基础的 BaseMapper 接口，已经实现了单表的 CRUD，自定义的 Mapper 只需要继承这个 BaseMapper，就无需自己实现单表 CRUD 了。
BaseMapper 包含了很多方法，示例：
Mapper 接口代码：
@Mapper
public interface UserInfoMapper extends BaseMapper<UserInfo> {}
也可以在启动类上添加 @MapperScan，扫描 Mapper 文件夹，如下：（二选一即可）
在创建出来的 SpringBoot 工程中，在 src 下的 test 目录下，创建测试类，可以直接使用这个测试类来进行测试。
编写单元测试，测试基本的 CRUD 功能：
@SpringBootTest
class MybatisPlusDemoApplicationTests {
@Autowired
private UserInfoMapper userInfoMapper;
@Test
public void testSelect() {
System.out.println("----- selectAll method test ------");
List<UserInfo> userList = userInfoMapper.selectList(null);
userList.forEach(System.out::println);
}
}
运行结果如下：
MyBatis 是如何知道，我们要操作的是哪张表，表里有哪些字段呢？
@Mapper
public interface UserInfoMapper extends BaseMapper<UserInfo> {}
UserInfoMapper 在继承 BaseMapper 时，指定了一个泛型，这个 UserInfo 就是与数据库表相对应的实体类。MyBatis-Plus 会根据这个实体类来推断表的信息。
默认情况下：
如果实体类和数据库不是按照上述规则定义。MyBatis-Plus 也给我们提供了一些注解，用来标识表的信息。
该注解用于指定实体类对应的数据库表名。当实体类名与数据库表名不一致，或者实体类名不是数据库表名的驼峰写法时，可以使用这个注解来明确指定表名。
示例：
@Data
@TableName("user_info")
public class Userinfo {
private Integer id;
private String username;
private String password;
private Integer age;
private Integer gender;
private String phone;
private Integer deleteFlag;
private Date createTime;
private Date updateTime;
}
该注解用于标记实体类中的非主键字段，它告诉 MyBatis-Plus 如何映射实体类字段到数据库表字段。如果实体类字段名遵循驼峰命名规则，并且与数据库表字段名一致，可以省略这个注解。
示例：
@Data
@TableName("user_info")
public class Userinfo {
private Integer id;
private String username;
private String password;
private Integer age;
private Integer gender;
private String phone;
@TableField("delete_flag")
private Integer deleteflag;
private Date createTime;
private Date updateTime;
}
该注解用于标记实体类中的主键字段。如果你的主键字段名为 id，可以省略这个注解。
示例：
@Data
@TableName("user_info")
public class Userinfo {
@TableId("id")
private Integer userId;
private String username;
private String password;
private Integer age;
private Integer gender;
private String phone;
@TableField("delete_flag")
private Integer deleteflag;
private Date createTime;
private Date updateTime;
}
如果属性名和字段名不一致，需要在@TableId 指明对应的字段名；属性名和字段一致的情况下，直接加@TableId 注解就可以。
@TableId 参数介绍：
""
描述：指定数据库表的主键字段名。如果不设置，MyBatis-Plus 将使用实体类中的字段名作为数据库表的主键字段名。IdType 枚举类型定义 IdType.AUTO：使用数据库自增 ID 作为主键。 IdType.NONE：无特定生成策略，如果全局配置中有 IdType 相关的配置，则会跟随全局配置。 IdType.INPUT：在插入数据前，由用户自行设置主键值。 IdType.ASSIGN_ID：自动分配 ID，适用于 Long、Integer、String 类型的主键。默认使用雪花算法通过 IdentifierGenerator 的 nextId 实现。 IdType.ASSIGN_UUID：自动分配 UUID，适用于 String 类型的主键。默认实现为 IdentifierGenerator 的 nextUUID 方法。
详情参考网址：注解配置
Mybatis-Plus 配置日志如下（application.yml）：
mybatis-plus:
configuration:
# 配置打印 MyBatis 日志
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
MyBatis-Plus 提供了一套强大的条件构造器 (Wrapper)，用于构建复杂的数据库查询条件。Wrapper 类允许开发者以链式调用的方式构造查询条件，无需编写繁琐的 SQL 语句，从而提高开发效率并减少 SQL 注入的风险。
以下是主要的 Wrapper 类及其功能：
QueryWrapper 并不只用于查询语句，无论是修改，删除，查询，都可以使用 QueryWrapper 来构建查询条件。
完成 SQL：
SELECT id,username,password,age FROM user_info WHERE age =18 AND username LIKE "%min%"
测试代码：
@Test
void testQueryWrapper() {
QueryWrapper<UserInfo> queryWrapper = new QueryWrapper<>();
queryWrapper.select("id","username","password","age").eq("age",18).like("username","min");
List<UserInfo> userInfos = userInfoMapper.selectList(queryWrapper);
userInfos.forEach(System.out::println);
}
完成 SQL：
UPDATE user_info SET delete_flag=? WHERE age <20
测试代码：
@Test
void testUpdateByQueryWrapper() {
QueryWrapper<UserInfo> queryWrapper = new QueryWrapper<>();
queryWrapper.lt("age",20);
UserInfo userInfo = new UserInfo();
userInfo.setDeleteFlag(1);
userInfoMapper.update(userInfo,queryWrapper);
}
条件方法说明：lt : "less than" 的缩写，表示小于 le : "less than or equal to" 的缩写，表示小于等于 ge : "greater than or equal to" 的缩写，表示大于等于 gt : "greater than" 的缩写，表示大于 eq : "equals" 的缩写，表示等于 ne : "not equals" 的缩写，表示不等于
完成 SQL：
DELETE FROM user_info WHERE age =18
测试代码：
@Test
void testDeleteByQueryWrapper() {
QueryWrapper<UserInfo> userInfoQueryWrapper = new QueryWrapper<UserInfo>().eq("age",18);
userInfoMapper.delete(userInfoQueryWrapper);
}
对于更新，也可以直接使用 UpdateWrapper，在不创建实体对象的情况下，直接设置更新字段和条件。
完成 SQL：
UPDATE user_info SET delete_flag=0, age=5 WHERE id IN(1,2,3)
测试代码：
@Test
void testUpdateWrapper() {
UpdateWrapper<UserInfo> updateWrapper = new UpdateWrapper<>();
updateWrapper.set("delete_flag",1).set("age",5).in("id",List.of(2,3,5,8));
userInfoMapper.update(updateWrapper);
}
完成 SQL：
UPDATE user_info SET age = age+10 WHERE id IN(1,2,3)
测试代码：
@Test
void testUpdateBySQLUpdateWrapper() {
UpdateWrapper<UserInfo> updateWrapper = new UpdateWrapper<UserInfo>().setSql("age = age+10").in("id",List.of(1,2,3));
userInfoMapper.update(null, updateWrapper);
}
QueryWrapper 和 UpdateWrapper 存在一个问题，就是需要写死字段名，如果字段名发生变更，可能会因为测试不到位酿成事故。
MyBatis-Plus 提供了一种基于 Lambda 表达式的条件构造器，它通过 Lambda 表达式来引用实体类的属性，从而避免了硬编码字段名，也提高了代码的可读性和可维护性。
分别对应上述的 QueryWrapper 和 UpdateWrapper。
@Test
void testLambdaQueryWrapper() {
QueryWrapper<UserInfo> queryWrapper = new QueryWrapper<UserInfo>();
queryWrapper.lambda().select(UserInfo::getUsername,UserInfo::getPassword,UserInfo::getAge).eq(UserInfo::getId,1);
userInfoMapper.selectList(queryWrapper).forEach(System.out::println);
}
LambdaUpdateWrapper 用法和 LambdaQueryWrapper 相似：
@Test
void testLambdaUpdateByUpdateWrapper() {
UpdateWrapper<UserInfo> updateWrapper = new UpdateWrapper<UserInfo>();
updateWrapper.lambda().set(UserInfo::getDeleteFlag,0).set(UserInfo::getAge,5).in(UserInfo::getId,List.of(1,2,3));
userInfoMapper.update(null, updateWrapper);
}
在实际的开发中，MyBatis-Plus 提供的操作不能满足所有的实际需求，MyBatis-Plus 也提供了自定义 SQL 的功能，可以利用 Wrapper 构造查询条件，再结合 Mapper 编写 SQL。
代码示例 1 完成下述 SQL 查询：
select id,username,password,age FROM user_info WHERE username ="admin"
Mapper：
@Mapper
public interface UserInfoMapper extends BaseMapper<UserInfo> {
@Select("select id,username,password,age FROM user_info ${ew.customSqlSegment}")
List<UserInfo> queryUserByCustom(@Param(Constants.WRAPPER) Wrapper<UserInfo> wrapper);
}
测试代码：
@Test
void testQueryUserByCustom() {
QueryWrapper<UserInfo> queryWrapper = new QueryWrapper<UserInfo>().eq("username","admin");
userInfoMapper.queryUserByCustom(queryWrapper).forEach(System.out::println);
}
注意：
${ew.customSqlSegment}：在 SQL 语句中，使用 ${ew.customSqlSegment} 来引用 Wrapper 对象生成的 SQL 片段。代码示例 2
MyBatis-Plus 在 MyBatis 的基础上只做增强不做改变，所以也支持 XML 的实现方式。上述功能也可以使用 XML 的方式完成。
配置 mapper 路径（application.yml）：
mybatis-plus:
mapper-locations:"classpath*:/mapper/**.xml"
# Mapper.xml
Mapper：
List<UserInfo> queryUserByCustom2(@Param(Constants.WRAPPER) Wrapper<UserInfo> wrapper);
编写 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.bite.mybatis.plus.mapper.UserInfoMapper">
<select id="queryUserByCustom2" resultType="com.bite.mybatis.plus.entity.UserInfo">
select id,username,password,age FROM user_info ${ew.customSqlSegment}
</select>
</mapper>
测试：
@Test
void testQueryUserByCustom2() {
QueryWrapper<UserInfo> queryWrapper = new QueryWrapper<UserInfo>().eq("username","admin");
userInfoMapper.queryUserByCustom2(queryWrapper).forEach(System.out::println);
}
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online