MyBatis-Plus-Join (MPJ) 框架介绍

MyBatis-Plus-Join (MPJ) 是一个基于 MyBatis-Plus 的多表关联查询框架，它提供了一种优雅的方式来处理复杂的表关联查询。

主要特性

1. Lambda 式查询

   wrapper.selectAs(Teacher::getId, TeacherLeaveVO::getTeacherId)
         .leftJoin(Course.class, Course::getTeacherId, Teacher::getId)
   

2. 自动字段映射

   // 自动映射所有字段
   wrapper.selectAll(Teacher.class)
         .selectAll(Course.class)
   

3. 灵活的关联方式

   // 支持左连接、右连接、内连接
   .leftJoin()  // 左连接
   .rightJoin() // 右连接
   .innerJoin() // 内连接
   

4. 分页查询支持

   mapper.selectJoinPage(new Page<>(current, size), VO.class, wrapper)
   

使用步骤

1. 添加依赖

   <dependency>
       <groupId>com.github.yulichang</groupId>
       <artifactId>mybatis-plus-join</artifactId>
       <version>1.4.6</version>
   </dependency>
   

2. Mapper 继承

   @Mapper
   public interface TeacherMapper extends MPJBaseMapper<Teacher> {
   }
   

3. 构建查询

   MPJLambdaWrapper<Teacher> wrapper = new MPJLambdaWrapper<>(Teacher.class)
           .selectAll(Teacher.class)
           .leftJoin(Course.class, Course::getTeacherId, Teacher::getId);
   

查询方式对比

传统 MyBatis

<select id="getTeacherLeaves">
    SELECT 
        t.id, t.name,
        c.id, c.name,
        sl.student_id, sl.leave_date
    FROM teacher t
    LEFT JOIN course c ON c.teacher_id = t.id
    LEFT JOIN student_leave sl ON sl.course_id = c.id
    WHERE t.id = #{teacherId}
</select>

MPJ 方式

wrapper.selectAll(Teacher.class)
       .selectAll(Course.class)
       .selectAll(StudentLeave.class)
       .leftJoin(Course.class, Course::getTeacherId, Teacher::getId)
       .leftJoin(StudentLeave.class, StudentLeave::getCourseId, Course::getId)

优势

1. 类型安全

   • 使用 Lambda 表达式，避免字段名拼写错误
   • 重构时自动更新关联字段

2. 代码简洁

   • 无需编写 XML
   • 链式调用更直观

3. 维护方便

   • 统一的查询方式
   • 复用查询条件

4. 功能完整

   • 支持分页
   • 支持多表关联
   • 支持字段别名
   • 支持条件构建

最佳实践

1. 抽取公共查询条件

   private MPJLambdaWrapper<Teacher> baseWrapper() {
       return new MPJLambdaWrapper<>(Teacher.class)
               .selectAll(Teacher.class)
               .selectAll(Course.class);
   }
   

2. 使用 VO 对象映射

   @Data
   public class TeacherLeaveVO {
       private Long teacherId;
       private String teacherName;
       // ...
   }
   

3. 合理使用字段选择

   // 选择特定字段而不是全部
   .select(Teacher::getId, Teacher::getName)
   // 需要所有字段时使用 selectAll
   .selectAll(Teacher.class)
   

注意事项

1. 字段命名要符合规范，建议使用驼峰命名
2. 合理使用表别名避免字段冲突
3. 关注查询性能，避免不必要的关联
4. 适当使用索引优化查询性能

MPJ 极大地简化了多表关联查询的编写，提高了开发效率，是一个值得使用的 MyBatis-Plus 扩展工具。