Mybatis-Plus中QueryWrapper 与 LambdaQueryWrapper 的区别

QueryWrapper 与 LambdaQueryWrapper 的区别

1.基本区别

QueryWrapper

java

// 使用字符串表示字段名 QueryWrapper<User> queryWrapper = new QueryWrapper<>(); queryWrapper.eq("name", "张三") .gt("age", 18) .like("email", "@qq.com");

LambdaQueryWrapper

java

// 使用Lambda表达式引用字段 LambdaQueryWrapper<User> lambdaWrapper = new LambdaQueryWrapper<>(); lambdaWrapper.eq(User::getName, "张三") .gt(User::getAge, 18) .like(User::getEmail, "@qq.com");

2.核心区别对比

3.详细对比

3.1 类型安全性

java

// QueryWrapper - 编译期不报错，运行时报错 queryWrapper.eq("nam", "张三"); // 拼写错误，编译时不检查 // LambdaQueryWrapper - 编译期报错 lambdaWrapper.eq(User::getNam, "张三"); // 编译时报错：找不到getNam方法

3.2 重构友好性

java

// QueryWrapper - 重命名需要手动修改 // 假设把字段 name 改为 username queryWrapper.eq("name", "张三"); // ❌ 需要手动改为 "username" // LambdaQueryWrapper - IDE自动重构 lambdaWrapper.eq(User::getName, "张三"); // ✅ 重命名实体类字段时自动更新

3.3 复杂查询对比

java

// QueryWrapper QueryWrapper<CapitalInfo> queryWrapper = new QueryWrapper<>(); if (StringUtils.isNotBlank(capitalName)) { queryWrapper.like("capital_name", capitalName); } if (capitalYear != null) { queryWrapper.eq("capital_year", capitalYear); } // LambdaQueryWrapper LambdaQueryWrapper<CapitalInfo> lambdaWrapper = new LambdaQueryWrapper<>(); lambdaWrapper.like(StringUtils.isNotBlank(capitalName), CapitalInfo::getCapitalName, capitalName) .eq(capitalYear != null, CapitalInfo::getCapitalYear, capitalYear);

4.实际使用示例

QueryWrapper 使用场景

java

// 1. 动态字段名（字段名是变量） String fieldName = getFieldNameFromRequest(); // 可能是 "name" 或 "username" QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq(fieldName, "张三"); // Lambda方式无法实现 // 2. 复杂动态SQL拼接 QueryWrapper<User> wrapper = new QueryWrapper<>(); if (condition1) { wrapper.eq("field1", value1); } else { wrapper.isNull("field1"); } if (condition2) { wrapper.in("field2", Arrays.asList(1, 2, 3)); } // 3. 表连接查询 QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq("u.status", 1) .eq("r.role_type", "admin") .apply("u.role_id = r.id");

LambdaQueryWrapper 使用场景

java

// 1. 常规查询（推荐） LambdaQueryWrapper<CapitalInfo> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(CapitalInfo::getCapitalState, 1) .like(CapitalInfo::getCapitalName, "测试") .orderByDesc(CapitalInfo::getCreateTime); // 2. 链式调用 List<CapitalInfo> list = capitalInfoMapper.selectList( new LambdaQueryWrapper<CapitalInfo>() .eq(CapitalInfo::getCapitalYear, 2024) .in(CapitalInfo::getCapitalType, Arrays.asList("A", "B", "C")) .groupBy(CapitalInfo::getCapitalSource) ); // 3. 条件判断简化 LambdaQueryWrapper<CapitalInfo> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(queryDTO.getCapitalState() != null, CapitalInfo::getCapitalState, queryDTO.getCapitalState()) .like(StringUtils.isNotBlank(queryDTO.getCapitalName()), CapitalInfo::getCapitalName, queryDTO.getCapitalName());

5.性能比较

两者在性能上没有区别，最终都会转换为相同的SQL语句：

sql

-- 两者生成的SQL相同 SELECT * FROM capital_info WHERE capital_state = 1 AND capital_name LIKE '%测试%' ORDER BY create_time DESC

6.最佳实践建议

推荐使用 LambdaQueryWrapper 的情况：

1. 查询条件固定，字段名不会动态变化

2. 注重代码可维护性和类型安全

3. 实体类字段可能重构的情况

4. 新项目开发，优先使用Lambda方式

推荐使用 QueryWrapper 的情况：

1. 字段名需要动态生成

2. 多表连接查询，涉及多个表的字段

3. 处理遗留代码，保持一致性

4. 构建复杂动态SQL，使用字符串更灵活

7.混合使用示例

java

// 可以使用QueryWrapper的lambda()方法 QueryWrapper<CapitalInfo> wrapper = new QueryWrapper<>(); wrapper.lambda() // 转换为Lambda方式 .eq(CapitalInfo::getCapitalState, 1) .like(CapitalInfo::getCapitalName, "测试"); // 或者反过来 LambdaQueryWrapper<CapitalInfo> lambdaWrapper = new LambdaQueryWrapper<>(); lambdaWrapper.eq(CapitalInfo::getCapitalState, 1); QueryWrapper<CapitalInfo> queryWrapper = lambdaWrapper.getWrapper(); // 可以继续添加字符串方式的查询条件 queryWrapper.apply("DATE(create_time) = CURDATE()");

8.结论

建议：在大部分业务场景下，优先使用LambdaQueryWrapper，因为它提供了更好的开发体验和代码安全性。只有在需要动态字段名或处理复杂SQL时，才使用QueryWrapper。