怎么使用MyBatis-Plus自带QueryWrapper自定义SQL实现复杂查询

MyBatis-Plus（简称MP）是MyBatis的增强工具，在MyBatis的基础上只做增强不做改变，简化开发、提高效率。其中，QueryWrapper是MyBatis-Plus提供的一个强大的查询条件构造器，可以帮助我们快速构建复杂的查询条件。本文将详细介绍如何使用QueryWrapper自定义SQL实现复杂查询。

1. QueryWrapper简介

QueryWrapper是MyBatis-Plus提供的一个查询条件构造器，它可以帮助我们快速构建SQL查询条件。通过QueryWrapper，我们可以链式调用各种条件方法，如eq、ne、gt、lt、like等，来构建复杂的查询条件。

1.1 基本用法

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.eq("name", "张三")
            .ge("age", 18)
            .orderByDesc("create_time");
List<User> userList = userMapper.selectList(queryWrapper);

上面的代码中，我们创建了一个QueryWrapper对象，并通过eq方法添加了一个等于条件，ge方法添加了一个大于等于条件，最后通过orderByDesc方法对结果进行排序。最终，selectList方法会根据这些条件查询出符合条件的用户列表。

1.2 常用方法

• eq：等于
• ne：不等于
• gt：大于
• ge：大于等于
• lt：小于
• le：小于等于
• like：模糊查询
• in：在某个集合中
• orderByAsc：升序排序
• orderByDesc：降序排序

2. 自定义SQL实现复杂查询

虽然QueryWrapper提供了丰富的条件构造方法，但在某些复杂的查询场景下，我们可能需要自定义SQL语句。MyBatis-Plus允许我们在使用QueryWrapper的同时，结合自定义SQL语句来实现复杂查询。

2.1 使用@Select注解

MyBatis-Plus支持在Mapper接口中使用@Select注解来定义SQL语句。我们可以将QueryWrapper的条件与自定义SQL结合使用。

@Select("SELECT * FROM user ${ew.customSqlSegment}")
List<User> selectListByWrapper(@Param(Constants.WRAPPER) QueryWrapper<User> queryWrapper);

在上面的代码中，${ew.customSqlSegment}是MyBatis-Plus提供的一个占位符，它会自动将QueryWrapper中的条件拼接到SQL语句中。

2.2 使用XML配置

除了使用@Select注解，我们还可以在MyBatis的XML配置文件中定义SQL语句，并结合QueryWrapper使用。

<select id="selectListByWrapper" resultType="User">
    SELECT * FROM user ${ew.customSqlSegment}
</select>

在Mapper接口中定义对应的方法：

List<User> selectListByWrapper(@Param(Constants.WRAPPER) QueryWrapper<User> queryWrapper);

2.3 复杂查询示例

假设我们需要查询年龄大于18岁且名字包含“张”的用户，并且按照创建时间降序排列。我们可以通过以下方式实现：

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.gt("age", 18)
            .like("name", "张")
            .orderByDesc("create_time");
List<User> userList = userMapper.selectListByWrapper(queryWrapper);

对应的SQL语句为：

SELECT * FROM user WHERE age > 18 AND name LIKE '%张%' ORDER BY create_time DESC

2.4 多表关联查询

在某些场景下，我们可能需要进行多表关联查询。MyBatis-Plus同样支持在自定义SQL中实现多表关联查询。

假设我们有两个表：user和order，我们需要查询用户及其订单信息。我们可以通过以下方式实现：

@Select("SELECT u.*, o.order_id, o.order_amount FROM user u LEFT JOIN order o ON u.user_id = o.user_id ${ew.customSqlSegment}")
List<UserOrderVO> selectUserOrderList(@Param(Constants.WRAPPER) QueryWrapper<User> queryWrapper);

在上面的代码中，我们定义了一个UserOrderVO类来接收查询结果。UserOrderVO类包含了用户信息和订单信息。

public class UserOrderVO {
    private Long userId;
    private String userName;
    private Integer age;
    private Long orderId;
    private BigDecimal orderAmount;
    // getter and setter
}

2.5 动态SQL

在某些复杂的查询场景下，我们可能需要根据不同的条件动态生成SQL语句。MyBatis-Plus提供了<if>标签来实现动态SQL。

<select id="selectUserList" resultType="User">
    SELECT * FROM user
    <where>
        <if test="name != null and name != ''">
            AND name LIKE CONCAT('%', #{name}, '%')
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
    ORDER BY create_time DESC
</select>

在Mapper接口中定义对应的方法：

List<User> selectUserList(@Param("name") String name, @Param("age") Integer age);

2.6 分页查询

MyBatis-Plus提供了Page类来实现分页查询。我们可以结合QueryWrapper和Page类来实现分页查询。

Page<User> page = new Page<>(1, 10); // 查询第1页，每页10条数据
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.gt("age", 18)
            .like("name", "张")
            .orderByDesc("create_time");
IPage<User> userPage = userMapper.selectPage(page, queryWrapper);

在上面的代码中，selectPage方法会根据Page对象和QueryWrapper条件进行分页查询，并返回一个IPage对象，其中包含了分页信息和查询结果。

2.7 自定义返回结果

在某些场景下，我们可能需要自定义查询结果的返回类型。MyBatis-Plus允许我们在自定义SQL中指定返回结果的类型。

@Select("SELECT user_id, user_name FROM user ${ew.customSqlSegment}")
List<Map<String, Object>> selectUserMapList(@Param(Constants.WRAPPER) QueryWrapper<User> queryWrapper);

在上面的代码中，我们使用了Map<String, Object>作为返回类型，这样可以灵活地处理查询结果。

3. 总结

MyBatis-Plus的QueryWrapper是一个非常强大的查询条件构造器，它可以帮助我们快速构建复杂的查询条件。通过结合自定义SQL语句，我们可以实现更加灵活和复杂的查询需求。无论是单表查询、多表关联查询，还是动态SQL、分页查询，MyBatis-Plus都提供了丰富的支持。

在实际开发中，我们可以根据具体的业务需求，灵活使用QueryWrapper和自定义SQL来实现各种复杂的查询场景。希望本文的介绍能够帮助大家更好地理解和使用MyBatis-Plus的QueryWrapper，提升开发效率。