使用 MyBatisPlus 的注解方式进行 SQL 查询，它结合了条件构造器（Wrapper）和自定义 SQL 片段来构建查询语句。

本文链接：https://blog.youkuaiyun.com/Microhoo_/article/details/133173270

本文介绍了如何在MyBatis-Plus中使用Wrapper和自定义SQL片段构建灵活的查询条件，以求和特定字段为例，展示如何通过LambdaQueryWrapper实现复杂查询功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

MyBatis-Plus 是一个基于 MyBatis 的增强工具，它提供了一套方便的注解方式来进行 SQL 查询。其中，它结合了条件构造器（Wrapper）和自定义 SQL 片段来构建查询语句。

官网：条件构造器 | MyBatis-Plus

1、使用 Wrapper 自定义SQL注意事项

需要mybatis-plus版本 >= 3.0.7

2、直接通过一个简单的示例进行讲解：

假设我们有一个名为"Order"的表，包含"orderId"和"amount"两列：

import lombok.Data;
import java.math.BigDecimal;
import java.time.LocalDateTime;

@Data
public class Order {
    private Long orderId;
    private Long userId;
    private BigDecimal amount;
    private LocalDateTime createTime;
}

现在，我们要查询某个用户在指定时间范围内的订单金额总和。可以按照以下方式编写代码：

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.reflection.Constants;

public interface OrderMapper extends BaseMapper<Order> {
    @Select("select sum(amount) from `order` ${ew.customSqlSegment}")
    BigDecimal queryTotalAmountByUserAndDate(@Param(Constants.WRAPPER) LambdaQueryWrapper<Order> wrapper);
}

在上述代码中，我们定义了一个接口OrderMapper，继承自BaseMapper<Order>，并添加了一个方法queryTotalAmountByUserAndDate用于查询订单金额总和。LambdaQueryWrapper<Order>用于构建查询条件。

接下来，在你的业务逻辑代码中，可以按照以下方式使用该方法：

import java.math.BigDecimal;
import java.time.LocalDateTime;

// ...

private BigDecimal queryTotalAmountByUserAndDate(Long userId, LocalDateTime begin, LocalDateTime end) {
    LambdaQueryWrapper<Order> wrapper = new LambdaQueryWrapper<Order>()
            .eq(Order::getUserId, userId)
            .between(Order::getCreateTime, begin, end);
    BigDecimal totalAmount = orderMapper.queryTotalAmountByUserAndDate(wrapper);
    return totalAmount == null ? BigDecimal.ZERO : totalAmount;
}

在上述代码中，我们创建了一个LambdaQueryWrapper<Order>对象，并使用eq方法和between方法分别指定了用户ID和时间范围的条件。

然后，我们调用queryTotalAmountByUserAndDate方法，并传入该wrapper对象进行查询。最后，根据查询结果判断并返回订单金额总和。

3、具体分析二者是如何结合使用的

（1）当使用SQL和Wrapper结合进行查询时，SQL用于编写具体的SQL语句，而Wrapper用于构建查询条件。

（2）SQL语句中的${ew.customSqlSegment}会被Wrapper对象中的条件替换，从而形成最终的SQL查询语句。Wrapper对象中的条件会根据具体的方法调用来生成相应的SQL片段，并替换${ew.customSqlSegment}。

在示例中：

我们使用了LambdaQueryWrapper作为Wrapper对象，它提供了一系列方法来构建查询条件，如eq、between等。

同时，我们在SQL语句中使用了sum(amount)来求和，这个部分是纯粹的SQL语法。

最后，通过调用queryTotalAmountByUserAndDate方法，我们将Wrapper对象传递给Mapper接口的查询方法，并使用${ew.customSqlSegment}将Wrapper中的条件注入到SQL语句中。执行查询后，得到的结果会返回给调用方。