Spring Boot与MyBatis-Plus的高效集成

引言

在现代 Java 开发中，MyBatis-Plus 作为 MyBatis 的增强工具，以其简化 CRUD 操作和无需编写 XML 映射文件的特点，受到了开发者的青睐。本篇文章将带你一步步整合 Spring Boot 与 MyBatis-Plus，并展示其在实际开发中的应用，包括事务管理、安全性考虑、性能优化等高级特性。
在这里插入图片描述

环境准备

1.1 导入依赖

在 pom.xml 文件中添加 MyBatis-Plus 的起步依赖：

<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.4.0</version>
</dependency>

确保使用 Maven Helper 插件检查依赖冲突。

1.2 修改配置文件

在 application.yml 中配置数据库连接和 MyBatis-Plus 参数：

server:port: 8889
spring:datasource:url: jdbc:mysql://localhost:3306/boot_mybatis?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&AllowPublicKeyRetrieval=Trueusername: rootpassword: 123456
mybatis-plus:mapper-locations: mapper/*.xmlconfiguration:log-impl: org.apache.ibatis.logging.stdout.StdOutImplmap-underscore-to-camel-case: truetype-aliases-package: com.example.demo.entity

1.3 IUser 实体类

定义 IUser 实体类，映射数据库中的用户表：

@Data
@TableName("t_user")
public class IUser {@TableId(value = "u_id", type = IdType.AUTO)private Integer uId;@TableField("user_name")private String userName;private String email;private String passWord;private Date birth;private int gender;
}

1.4 UserMapper 接口

创建 UserMapper 接口，继承 BaseMapper：

@Mapper
public interface IUserMapper extends BaseMapper<IUser> {}

使用

2.1 基础增删改查

新增一条 User 数据

@Autowired
private IUserMapper userMapper;@Test
public void insertUser() {IUser user = new IUser();user.setUserName("曹操");user.setPassWord("88888888");user.setEmail("321@qin.com");userMapper.insert(user);
}

根据条件删除 User

@Test
public void deleteUserById() {userMapper.deleteById(1001);
}

2.2 批量操作

批量新增

@Test
public void batchInsertUsers() {List<IUser> users = Arrays.asList(new IUser().setUserName("关羽").setPassWord("258"),new IUser().setUserName("关公").setPassWord("7530"),new IUser().setUserName("关项").setPassWord("159"));userMapper.insertBatch(users);
}

2.3 查询条件构造器【QueryWrapper】使用

使用 QueryWrapper 构造查询条件：

@Test
public void selectUsersByQueryWrapper() {QueryWrapper<IUser> queryWrapper = new QueryWrapper<>();queryWrapper.eq("user_name", "项羽").like("email", "123@163.com");userMapper.selectList(queryWrapper);
}

2.4 修改条件构造器【UpdateWrapper】使用

使用 UpdateWrapper 构造更新条件：

@Test
public void updateUserByUpdateWrapper() {UpdateWrapper<IUser> updateWrapper = new UpdateWrapper<>();updateWrapper.eq("user_name", "王小五").set("email", "wxw@qq.com");userMapper.update(null, updateWrapper);
}

2.5 事务管理

事务的配置

在服务层方法上使用 @Transactional 注解来确保操作的原子性。

@Service
public class UserService {@Autowiredprivate IUserMapper userMapper;@Transactionalpublic void updateUserAndSendEmail(String userName, String newEmail) {// 更新用户信息IUser user = new IUser();user.setUserName(userName);user.setEmail(newEmail);userMapper.updateById(user);// 发送邮件操作（示例）sendEmailToUser(userName, newEmail);}private void sendEmailToUser(String userName, String email) {// 邮件发送逻辑}
}

事务的传播行为

Spring 支持多种事务传播行为，可以根据业务需求配置。

2.6 安全性考虑

防止 SQL 注入

MyBatis-Plus 通过预编译的语句防止 SQL 注入。

数据加密

在应用层对敏感数据进行加密，比如用户密码的存储和验证。

public class SecurityUtils {public static String encryptPassword(String password) {// 加密密码逻辑}public static boolean checkPassword(String rawPassword, String encryptedPassword) {// 验证密码逻辑}
}

代码生成器

在这里插入图片描述

3.1 准备项目和数据库表

准备一个 Spring Boot 空项目，并创建数据库表：

CREATE TABLE `t_user` (`u_id` int NOT NULL AUTO_INCREMENT COMMENT '主键',`user_name` varchar(10) NOT NULL COMMENT '用户登录名',`email` varchar(50) DEFAULT NULL COMMENT '邮箱',`pass_word` varchar(30) NOT NULL COMMENT '密码',...PRIMARY KEY (`u_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3;

3.2 引入依赖

在 pom.xml 中添加代码生成器的依赖：

<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-generator</artifactId><version>3.4.0</version>
</dependency>
<dependency><groupId>org.apache.velocity</groupId><artifactId>velocity-engine-core</artifactId><version>2.0</version>
</dependency>

3.3 配置文件

在 application.yml 中配置数据库连接：

spring:datasource:url: jdbc:mysql://localhost:3306/generate?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&AllowPublicKeyRetrieval=Trueusername: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Driver

3.4 测试工具类

创建一个测试工具类，用于自动生成代码：

public class CodeGenerator {public static void main(String[] args) {AutoGenerator mpg = new AutoGenerator();mpg.setDataSource(new DataSourceConfig.Builder().setUrl("jdbc:mysql://localhost:3306/generate?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&AllowPublicKeyRetrieval=True").setDriverName("com.mysql.cj.jdbc.Driver").setUsername("root").setPassword("123456").build());mpg.setGlobalConfig(new GlobalConfig.Builder().setOutputDir(System.getProperty("user.dir") + "/src/main/java").setAuthor("Your Name").setOpen(false).build());mpg.setPackageInfo(new PackageConfig.Builder().setParent("com.example.demo").setEntity("entity").setMapper("mapper").setService("service").setController("controller").build());mpg.setStrategy(new StrategyConfig.Builder().setInclude("t_user").build());mpg.execute();}
}

3.5 生成目录结构

运行上述测试工具类，生成项目的目录结构。

3.6 调整和测试

调整生成的 Mapper XML 文件位置，并在 Mapper 接口上添加 @Mapper 注解。在启动类上添加 @MapperScan 注解。然后进行测试，例如新增一个用户：

@Autowired
private TUserMapper userMapper;@Test
public void testInsertUser() {TUser user = new TUser();user.setUserName("王中王");user.setPassWord("wzw123456");userMapper.insert(user);
}