在 MyBatis-Plus 中，wrapper.apply() 方法允许你在构建查询条件时插入任意的 SQL 片段。这对于实现一些复杂的查询需求特别有用，比如添加子查询、使用数据库特定函数等；
示例 1: 基本应用
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import java.util.List;
// 假设 User 是你的实体类
public List<User> getUsersOlderThanAverage() {
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
// 使用 apply 方法添加自定义 SQL 片段
queryWrapper.apply("age > (select avg(age) from user)");
return userMapper.selectList(queryWrapper);
}
在这个例子中，apply 方法被用来添加一个子查询来计算平均年龄，并选择所有年龄大于平均年龄的用户。
示例 2: 使用占位符
为了提高安全性并避免 SQL 注入，推荐在 apply 方法中使用占位符 {} 来代替直接拼接变量。
Integer minAge = 20;
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
// 使用 apply 方法添加带参数的自定义 SQL 片段
queryWrapper.apply("age > {0}", minAge);
List<User> users = userMapper.selectList(queryWrapper);
这里 {0} 是占位符，它会被 minAge 的值替换。如果有多个参数，可以依次使用 {1}, {2} 等。
示例 3: 结合其他条件
apply 方法可以与其他条件一起使用，比如 eq, gt, lt 等，以构建更复杂的查询逻辑。
String emailDomain = "example.com";
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
// 组合多种查询条件
queryWrapper.gt("age", 20)
.isNotNull("email")
.apply("email like {0}", "%"+emailDomain+"%");
List<User> users = userMapper.selectList(queryWrapper);
在这个例子中，我们不仅检查了用户的年龄是否大于20岁以及邮箱是否非空，还添加了一个额外的条件来筛选邮箱包含特定域名的用户。
注意事项
- SQL 注入防护：虽然 apply 方法支持参数化查询，减少了 SQL 注入的风险，但在编写原生 SQL 时仍需小心。
- 字段名准确性：确保你指定的字段名与数据库中的列名完全匹配。如果实体类中的属性名与数据库列名不一致，可能需要使用数据库的实际列名。
- 复杂性管理：对于非常复杂的查询逻辑，尤其是涉及多个表连接的情况，考虑是否更适合直接在 XML 文件中定义 SQL 或者使用注解方式来实现。
- 分页查询：当结合分页查询使用时，请确保正确设置了 Page 对象，以便 MyBatis-Plus 可以为你的查询添加适当的分页信息。
分页查询的例子
如果你想对带有 apply 方法的查询进行分页，可以这样做：
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
Page<User> page = new Page<>(1, 10); // 第1页，每页10条记录
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
// 添加自定义 SQL 片段
queryWrapper.apply("age > {0}", 20);
IPage<User> resultPage = userMapper.selectPage(page, queryWrapper);
System.out.println("总记录数：" + resultPage.getTotal());
System.out.println("当前页数据：" + resultPage.getRecords());
