Mybatis-Plus-Join表連接插件集成過程

更新時間：2025年09月08日 14:13:29 作者：劉火鍋

Mybatis-Plus-Join是Mybatis-Plus的擴展插件,支持左、右、內(nèi)連接查詢,保持原有開發(fā)風格,通過JoinLambdaWrapper配置連接關系與查詢條件,簡化多表關聯(lián)操作,提升復雜SQL編寫效率

概要

Mybatis-Plus-Join 是基于 Mybatis-Plus 的擴展插件，提供了簡便的表連接查詢功能，支持左連接、右連接和內(nèi)連接等操作，同時保持 Mybatis-Plus 的使用風格。

官方文檔：https://mpj.aicats.cc/

安裝配置

1.添加依賴

在 pom.xml 中添加以下依賴：

<dependency>
    <groupId>com.github.yulichang</groupId>
    <artifactId>mybatis-plus-join-boot-starter</artifactId>
    <version>1.4.5</version>
</dependency>

2.配置繼承結構

Mapper 層繼承

import icu.mhb.mybatisplus.plugln.base.mapper.JoinBaseMapper;

public interface UserMapper extends JoinBaseMapper<User> {
   
}

Service 接口繼承

import icu.mhb.mybatisplus.plugln.base.service.JoinIService;

public interface UserService extends JoinIService<User> {
   
}

Service 實現(xiàn)層繼承

import icu.mhb.mybatisplus.plugln.base.service.impl.JoinServiceImpl;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends JoinServiceImpl<UserMapper, User> implements UserService {
   
}

基本使用方法

1. 創(chuàng)建 JoinLambdaWrapper

在 Service 中可直接使用 joinLambdaWrapper() 方法：

// 方式一：通過 Service 直接獲取
JoinLambdaWrapper<User> wrapper = userService.joinLambdaWrapper();

// 方式二：手動創(chuàng)建
JoinLambdaWrapper<User> wrapper = new JoinLambdaWrapper<>(User.class);

2. 添加表連接

支持三種連接方式：

// 左連接
wrapper.leftJoin(Department.class, Department::getId, User::getDeptId);

// 右連接
wrapper.rightJoin(Department.class, Department::getId, User::getDeptId);

// 內(nèi)連接
wrapper.innerJoin(Department.class, Department::getId, User::getDeptId);

3. 添加查詢條件

wrapper.eq(Department::getName, "技術部")
       .like(User::getName, "張")
       .gt(User::getAge, 25);

4. 結束連接并執(zhí)行查詢

// 結束當前連接（重要！）
wrapper.end();

// 執(zhí)行查詢
List<UserVO> result = userService.joinList(wrapper, UserVO.class);

多表連接示例

public List<UserVO> findUsersWithMultiJoin() {
    JoinLambdaWrapper<User> wrapper = userService.joinLambdaWrapper();
    
    // 第一重連接：部門表
    wrapper.leftJoin(Department.class, Department::getId, User::getDeptId)
           .selectAs(Department::getName, UserVO::getDeptName)
           .end();
    
    // 第二重連接：職位表
    wrapper.leftJoin(Position.class, Position::getUserId, User::getId)
           .eq(Position::getLevel, "P7")
           .selectAs(Position::getName, UserVO::getPositionName)
           .end();
    
    return userService.joinList(wrapper, UserVO.class);
}