MyBatis-Plus 是 MyBatis 的增强工具，旨在简化开发、提高效率并保持 MyBatis 的灵活性。本文将详细介绍 MyBatis-Plus 的高级用法，帮助开发者最优化持久层开发。
一、MyBatis-Plus 简介
MyBatis-Plus 是一个 ORM 框架，提供了 CRUD 接口、条件构造器、代码生成器等功能，简化了常见的持久层开发工作。
核心功能
- CRUD 接口：简单的增删改查操作。
- 条件构造器：动态生成 SQL 查询条件。
- 分页插件：简化分页查询操作。
- 逻辑删除：轻松实现软删除功能。
- 代码生成器：自动生成实体类、Mapper 接口等代码。
二、快速入门
1. 添加依赖
在 pom.xml 中添加 MyBatis-Plus 依赖：
<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.4.3.4</version>
</dependency>
2. 配置数据源
在 application.yml 中配置数据源：
spring:datasource:url: jdbc:mysql://localhost:3306/mydbusername: rootpassword: rootdriver-class-name: com.mysql.cj.jdbc.Driver
3. 创建实体类
创建一个实体类 User：
@Data
@TableName("user")
public class User {private Long id;private String name;private Integer age;private String email;
}
4. 创建 Mapper 接口
创建 Mapper 接口并继承 BaseMapper：
public interface UserMapper extends BaseMapper<User> {
}
5. 编写服务类
编写服务类使用 UserMapper：
@Service
public class UserService {@Autowiredprivate UserMapper userMapper;public List<User> getAllUsers() {return userMapper.selectList(null);}
}
6. 编写控制器
编写控制器调用服务类：
@RestController
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserService userService;@GetMapping("/list")public List<User> list() {return userService.getAllUsers();}
}
三、高级用法
1. 条件构造器
MyBatis-Plus 提供了 QueryWrapper 和 UpdateWrapper 用于动态构造查询和更新条件。
1.1 QueryWrapper
QueryWrapper 用于构建查询条件：
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.eq("name", "John");
List<User> users = userMapper.selectList(queryWrapper);
1.2 UpdateWrapper
UpdateWrapper 用于构建更新条件：
UpdateWrapper<User> updateWrapper = new UpdateWrapper<>();
updateWrapper.eq("name", "John").set("age", 30);
userMapper.update(null, updateWrapper);
2. 分页插件
分页插件简化了分页查询：
@Autowired
private UserMapper userMapper;public IPage<User> getUsersByPage(int pageNum, int pageSize) {Page<User> page = new Page<>(pageNum, pageSize);return userMapper.selectPage(page, null);
}
3. 逻辑删除
逻辑删除不删除数据，只是标记为已删除。首先在实体类中配置逻辑删除字段：
@TableLogic
private Integer deleted;
在 application.yml 中启用逻辑删除：
mybatis-plus:global-config:db-config:logic-delete-value: 1logic-not-delete-value: 0
使用时直接调用 deleteById 方法即可：
userMapper.deleteById(1L);
4. 代码生成器
代码生成器自动生成实体类、Mapper 接口、Service 类和 Controller 类。以下是代码生成器的简单示例：
@Data
public class CodeGenerator {public static void main(String[] args) {AutoGenerator autoGenerator = new AutoGenerator();// 数据源配置DataSourceConfig dataSourceConfig = new DataSourceConfig();dataSourceConfig.setUrl("jdbc:mysql://localhost:3306/mydb");dataSourceConfig.setDriverName("com.mysql.cj.jdbc.Driver");dataSourceConfig.setUsername("root");dataSourceConfig.setPassword("root");autoGenerator.setDataSource(dataSourceConfig);// 包名配置PackageConfig packageConfig = new PackageConfig();packageConfig.setParent("com.example.demo");autoGenerator.setPackageInfo(packageConfig);// 策略配置StrategyConfig strategyConfig = new StrategyConfig();strategyConfig.setInclude("user"); // 表名strategyConfig.setNaming(NamingStrategy.underline_to_camel);strategyConfig.setColumnNaming(NamingStrategy.underline_to_camel);strategyConfig.setEntityLombokModel(true);autoGenerator.setStrategy(strategyConfig);autoGenerator.execute();}
}
5. 自定义 SQL 注入器
可以自定义 SQL 注入器，实现个性化需求。例如，添加一个批量插入的方法：
@Component
public class MySqlInjector extends AbstractSqlInjector {@Overridepublic List<AbstractMethod> getMethodList(Class<?> mapperClass) {List<AbstractMethod> methodList = super.getMethodList(mapperClass);methodList.add(new InsertBatchSomeColumn());return methodList;}
}
四、最佳实践
1. 分层架构
建议遵循分层架构，将控制器、服务、数据访问层分开，提高代码的可维护性。
2. 统一异常处理
使用 @ControllerAdvice 统一处理异常，提升系统的健壮性。
3. 使用事务管理
在服务层使用 @Transactional 注解管理事务，确保数据一致性：
@Transactional
public void updateUser(User user) {userMapper.updateById(user);
}
4. 性能优化
- 使用批量操作：对于大批量数据操作，使用 MyBatis-Plus 提供的批量操作接口，提高性能。
- 索引优化：确保数据库中相关表和字段有适当的索引，提升查询性能。
五、总结
MyBatis-Plus 通过简化常见的持久层开发任务，提高了开发效率和代码的可维护性。通过合理使用条件构造器、分页插件、逻辑删除和代码生成器等高级功能，可以进一步优化持久层开发，提升系统性能和稳定性。
