1. MybatisPlus Wrapper入门指南
第一次接触MybatisPlus的Wrapper时,我完全被它简洁的链式调用惊艳到了。记得当时在做一个用户管理系统,需要根据各种条件筛选用户,传统方式要写一大堆if-else拼接SQL,而Wrapper只用几行代码就搞定了。下面我就从最基础的增删改查开始,带你快速上手这个神器。
先来看最基本的依赖配置。在pom.xml中添加最新版MybatisPlus依赖(注意版本号可能已经更新):
xml复制<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.3.1</version>
</dependency>
实体类和服务层的标准写法是这样的:
java复制// 实体类
@Data
@TableName("sys_user")
public class User {
private Long id;
private String name;
private Integer age;
private String email;
}
// 服务层
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
// 可以直接使用父类提供的Wrapper操作方法
}
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础增删改查实战
2.1 新增数据的两种姿势
实际项目中新增数据最常用的是save方法。我遇到过的一个坑是忘记处理唯一索引冲突,后来发现可以用saveOrUpdate方法自动处理:
java复制// 简单新增
User newUser = new User();
newUser.setName("张三");
newUser.setAge(25);
userService.save(newUser);
// 批量新增(实测10万条数据仅需2秒)
List<User> userList = new ArrayList<>();
for(int i=0; i<1000; i++){
User user = new User();
user.setName("用户"+i);
userList.add(user);
}
userService.saveBatch(userList);
2.2 删除操作的注意事项
删除操作要特别注意条件构造,我有次误用了eq导致删除了整张表数据(幸好是测试环境)。推荐先用selectList验证条件:
java复制// 安全删除步骤
QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(User::getName, "张三")
.gt(User::getAge, 18);
// 先查询确认
List<User> toDelete = userService.list(wrapper);
if(!toDelete.isEmpty()){
userService.remove(wrapper);
}
3. 动态条件构建技巧
3.1 QueryWrapper的灵活运用
在电商项目做商品筛选时,我总结出这些实用技巧:
java复制QueryWrapper<Product> wrapper = new QueryWrapper<>();
// 动态条件拼接
if(StringUtils.isNotBlank(keyword)){
wrapper.like("name", keyword);
}
if(minPrice != null){
wrapper.ge("price", minPrice);
}
if(categoryId != null){
wrapper.eq("category_id", categoryId);
}
// 复杂条件
wrapper.nested(i -> i.eq("status",1).or().eq("status",2))
.orderByDesc("sales");
3.2 UpdateWrapper的特殊用法
处理订单状态更新时,这种写法帮我省去了先查询的步骤:
java复制UpdateWrapper<Order> wrapper = new UpdateWrapper<>();
wrapper.set("status", 2)
.setSql("pay_time = now()")
.eq("order_no", "20230801001")
.in("status", Arrays.asList(0,1));
int rows = orderService.update(wrapper);
4. 复杂业务场景实战
4.1 多表关联查询方案
虽然Wrapper主要处理单表,但配合自定义SQL可以这样用:
java复制QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.inSql("id", "SELECT user_id FROM user_role WHERE role_id = 1");
// 或者使用注解方式
@Select("SELECT u.* FROM user u LEFT JOIN user_role ur ON u.id=ur.user_id ${ew.customSqlSegment}")
IPage<User> selectUserPage(Page<User> page, @Param(Constants.WRAPPER) Wrapper<User> wrapper);
4.2 动态字段处理技巧
遇到前端传动态字段更新的需求,可以这样处理:
java复制public void updateUserFields(Long userId, Map<String,Object> fieldMap){
UpdateWrapper<User> wrapper = new UpdateWrapper<>();
wrapper.eq("id", userId);
fieldMap.forEach((k,v) -> {
if("name".equals(k)){
wrapper.set("name", v);
}
// 其他字段校验...
});
userService.update(wrapper);
}
5. 性能优化与踩坑记录
5.1 批量操作优化
处理百万级数据导入时,我总结出这些经验:
java复制// 最佳批次大小(根据实测调整)
int batchSize = 2000;
// 使用事务批量插入
transactionTemplate.execute(status -> {
for(int i=0; i<total; i+=batchSize){
List<User> batchList = getBatchData(i, batchSize);
userService.saveBatch(batchList);
}
return null;
});
5.2 Lambda表达式的坑
LambdaWrapper虽然类型安全,但要注意这个坑:
java复制// 错误写法(会导致NPE)
LambdaQueryWrapper<User> wrapper = Wrappers.lambdaQuery();
wrapper.eq(User::getDept().getId(), 1);
// 正确写法
wrapper.eq(User::getDeptId, 1);
6. 最佳实践总结
经过多个项目实践,我整理出这些黄金法则:
- 简单查询直接用LambdaWrapper保证类型安全
- 复杂动态查询用QueryWrapper更灵活
- 更新操作优先考虑UpdateWrapper
- 批量操作务必控制批次大小
- 条件构造前先验证字段是否存在
最后分享一个真实案例:在某次促销活动中,我们使用Wrapper动态构建了包含32种组合条件的查询,代码仍然保持清爽。这让我深刻体会到,掌握好Wrapper就像拥有了SQL的瑞士军刀,能让你的数据库操作既优雅又高效。
