mybaits-plus LEFT JOIN

### MyBatis-Plus 中 LEFT JOIN 的使用方法 MyBatis-Plus (简称 MP) 是一款增强型的 MyBatis 框架，其扩展插件 **MyBatis-Plus-Join** 提供了强大的多表联查能力。通过 `MPJLambdaWrapper` 或 `MPJQueryWrapper` 类，开发者能够轻松实现复杂的 SQL 查询逻辑，包括左连接 (`LEFT JOIN`)。 #### 工具简介 MyBatis-Plus-Join 插件的核心在于提供了一种无需手写复杂 SQL 即可完成多表联合查询的方式[^1]。对于初学者来说，掌握该工具的基础用法尤为重要。以下是关于如何在 MyBatis-Plus 中使用 `LEFT JOIN` 的具体示例： --- #### 示例代码：LEFT JOIN 实现用户与订单信息查询 假设存在两张表： 1. 用户表 (`user`)：存储用户的个人信息。 2. 订单表 (`order`)：存储用户的订单详情。 目标是从数据库中获取所有用户的信息以及他们的订单信息（即使某些用户没有订单也需显示）。 ##### 数据库结构 ```sql -- 用户表 CREATE TABLE user ( id BIGINT PRIMARY KEY, name VARCHAR(50), age INT ); -- 订单表 CREATE TABLE orders ( id BIGINT PRIMARY KEY, user_id BIGINT, order_name VARCHAR(100), amount DECIMAL(10, 2) ); ``` ##### Java 实体类定义 ```java @Data public class User { private Long id; private String name; private Integer age; } @Data public class Order { private Long id; private Long userId; // 对应外键 private String orderName; private BigDecimal amount; } ``` ##### 自定义 VO 返回对象 为了简化前端展示，通常会创建一个新的视图对象 (VO)，用于封装多个表的结果集。 ```java @Data public class UserOrderVO { private Long userId; private String userName; private Integer userAge; private List<Order> orders; // 关联的订单集合 } ``` --- #### 使用 MPJLambdaWrapper 实现 LEFT JOIN 查询 以下是一个完整的代码示例，演示如何通过 `MPJLambdaWrapper` 执行 `LEFT JOIN` 并返回结果。 ```java import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; @Service public class UserService { @Autowired private UserMapper userMapper; public Page<UserOrderVO> getUserWithOrders(int currentPage, int pageSize) { // 创建分页对象 Page<UserOrderVO> page = new Page<>(currentPage, pageSize); // 构建 MPJLambdaWrapper 包裹器 MPJLambdaWrapper<User> wrapper = Wrappers.mpj LambdaWrapper(User.class) .selectAs(User::getId, "userId") // 主表字段映射 .selectAs(User::getName, "userName") .selectAs(User::getAge, "userAge") .leftJoin(Order.class, "o") // 添加左连接 .on("u.id = o.user_id") // 设置关联条件 .selectList("o.*"); // 获取子表的所有字段 // 调用 Mapper 方法执行查询并返回分页结果 return userMapper.selectJoinPage(page, wrapper); } } ``` --- #### 注意事项 1. **主表的选择** 在构建 `MPJLambdaWrapper` 时，必须指定主表对应的实体类型作为泛型参数。上述例子中，`User.class` 是主表实体[^3]。 2. **字段别名处理** 如果涉及跨表查询，则需要为不同表的字段起别名以防止冲突。例如，在上面的例子中，`User` 表的字段被重命名为带有前缀的形式（如 `userId`, `userName`），以便区分来自其他表的同名字段。 3. **性能优化建议** 尽管框架已经进行了大量底层优化，但对于大规模数据量场景仍需注意避免不必要的全表扫描。推荐仅选取实际需要用到的列而非通配符 (*)[^4]。 --- #### 测试验证 针对以上功能模块，应当编写充分的单元测试案例来覆盖各种边界情况，比如当某个用户没有任何订单记录时是否仍然正常返回等问题。这样可以有效提升系统的稳定性和可靠性。 --- ### 总结 借助 MyBatis-Plus-Join 插件的强大特性，即使是较为复杂的多表联查也可以变得简单高效。只需熟悉几个核心 API 如 `MPJLambdaWrapper` 及其链式调用语法即可快速上手开发工作流。 ---