来了，MyBatisPlus的join联表查询！

最新推荐文章于 2025-09-05 15:15:01 发布
转载 最新推荐文章于 2025-09-05 15:15:01 发布 · 1.3w 阅读 · 45 ·
CC 4.0 BY-SA版权
原文链接：https://mp.weixin.qq.com/s?__biz=MzI5MzYzMDAwNw==&mid=2247498268&idx=1&sn=d41b120d697aa6698fe1d95df6abff90&chksm=ec6d8344db1a0a52218760a373c990b4f3465ee8cbdc253ddb72b65abf058a7f7f59e6910bec&scene=126&&sessionid=0
文章标签：

#数据库 #mysql #java #mybatis #sql

来源：juejin.cn/post/

7110405284811522085

154577215ca1787e0285ad0aed5c99cf.jpeg

众所周知，mybatis plus 封装的 mapper 不支持 join，如果需要支持就必须自己去实现。但是对于大部分的业务场景来说，都需要多表 join，要不然就没必要采用关系型数据库了。

那么有没有一种不通过硬 SQL 的形式，通过框架提供 join 能力呢？答案是，可以有。经过一段时间的插眼排眼操作，成功的封装了一个 jar 包。本文讲讲它的用法。

使用方法

安装

  • Maven

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

  • Gradle

implementation 'com.github.yulichang:mybatis-plus-join:1.2.4'

或者 clone 代码到本地执行 mvn install，再引入以上依赖。

注意：mybatis plus version >= 3.4.0。

使用

  • mapper继承MPJBaseMapper (必选)

  • service继承MPJBaseService (可选)

  • serviceImpl继承MPJBaseServiceImpl (可选)

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能。

项目地址：https://github.com/YunaiV/ruoyi-vue-pro

核心类 MPJLambdaWrapper和MPJQueryWrapper

MPJLambdaWrapper用法

简单的三表查询
class test {
    @Resource
    private UserMapper userMapper;

    void testJoin() {
        List<UserDTO> list = userMapper.selectJoinList(UserDTO.class,
                new MPJLambdaWrapper<UserDO>()
                        .selectAll(UserDO.class)
                        .select(UserAddressDO::getTel)
                        .selectAs(UserAddressDO::getAddress, UserDTO::getUserAddress)
                        .select(AreaDO::getProvince, AreaDO::getCity)
                        .leftJoin(UserAddressDO.class, UserAddressDO::getUserId, UserDO::getId)
                        .leftJoin(AreaDO.class, AreaDO::getId, UserAddressDO::getAreaId)
                        .eq(UserDO::getId, 1)
                        .like(UserAddressDO::getTel, "1")
                        .gt(UserDO::getId, 5));
    }
}

对应sql

SELECT 
    t.id,
    t.name,
    t.sex,
    t.head_img,
    t1.tel,
    t1.address AS userAddress,
    t2.province,
    t2.city 
FROM 
    user t 
    LEFT JOIN user_address t1 ON t1.user_id = t.id 
    LEFT JOIN area t2 ON t2.id = t1.area_id 
WHERE (
    t.id = ? 
    AND t1.tel LIKE ? 
    AND t.id > ?)

说明:

  • UserDTO.class 查询结果返回类(resultType)

  • selectAll() 查询指定实体类的全部字段

  • select() 查询指定的字段,支持可变参数,同一个select只能查询相同表的字段 故将UserAddressDO和AreaDO分开为两个select()

  • selectAs() 字段别名查询,用于数据库字段与业务实体类属性名不一致时使用

  • leftJoin() 参数说明 第一个参数: 参与连表的实体类class 第二个参数: 连表的ON字段,这个属性必须是第一个参数实体类的属性 第三个参数: 参与连表的ON的另一个实体类属性

  • 默认主表别名是t,其他的表别名以先后调用的顺序使用t1,t2,t3....

  • 条件查询,可以查询主表以及参与连接的所有表的字段,全部调用mp原生的方法,正常使用没有sql注入风险

MPJLambdaWrapper 还有很多其他的功能

  • 简单的SQL函数使用：https://gitee.com/best_handsome/mybatis-plus-join/wikis/selectFunc()?sort_id=4082479

  • ON语句多条件支持：https://gitee.com/best_handsome/mybatis-plus-join/wikis/leftJoin?sort_id=3496671

分页查询
class test {
    @Resource
    private UserMapper userMapper;

    void testJoin() {
        IPage<UserDTO> iPage = userMapper.selectJoinPage(new Page<>(2, 10), UserDTO.class,
                new MPJLambdaWrapper<UserDO>()
                        .selectAll(UserDO.class)
                        .select(UserAddressDO::getTel)
                        .selectAs(UserAddressDO::getAddress, UserDTO::getUserAddress)
                        .select(AreaDO::getProvince, AreaDO::getCity)
                        .leftJoin(UserAddressDO.class, UserAddressDO::getUserId, UserDO::getId)
                        .leftJoin(AreaDO.class, AreaDO::getId, UserAddressDO::getAreaId));
    }
}

对应sql

SELECT 
    t.id,
    t.name,
    t.sex,
    t.head_img,
    t1.tel,
    t1.address AS userAddress,
    t2.province,
    t2.city
FROM 
    user t
    LEFT JOIN user_address t1 ON t1.user_id = t.id
    LEFT JOIN area t2 ON t2.id = t1.area_id
LIMIT ?,?

MPJQueryWrapper

简单的3表查询
class test {
    @Resource
    private UserMapper userMapper;

    void testJoin() {
        List<UserDTO> list = userMapper.selectJoinList(UserDTO.class,
                new MPJQueryWrapper<UserDO>()
                        .selectAll(UserDO.class)
                        .select("addr.tel", "addr.address", "a.province")
                        .leftJoin("user_address addr on t.id = addr.user_id")
                        .rightJoin("area a on addr.area_id = a.id")
                        .like("addr.tel", "1")
                        .le("a.province", "1"));
    }
}

对应 sql

SELECT 
    t.id,
    t.name,
    t.sex,
    t.head_img,
    addr.tel,
    addr.address,
    a.province
FROM 
    user t
    LEFT JOIN user_address addr on t.id = addr.user_id
    RIGHT JOIN area a on addr.area_id = a.id
WHERE (
    addr.tel LIKE ?
    AND a.province <= ?)

说明:

  • UserDTO.class 查询结果类(resultType)

  • selectAll(UserDO.class) 查询主表全部字段(主表实体类)默认主表别名 "t"

  • select() mp的select策略是覆盖,以最后一次为准,这里的策略是追加,可以一直select 主表字段可以用lambda,会自动添加表别名,主表别名默认是 t ,非主表字段必须带别名查询

  • leftJoin() rightJoin() innerJoin() 传sql片段 格式 (表 + 别名 + 关联条件)

  • 条件查询,可以查询主表以及参与连接的所有表的字段,全部调用mp原生的方法,正常使用没有sql注入风险

分页查询
class test {
    @Resource
    private UserMapper userMapper;

    void testJoin() {
        IPage<UserDTO> page = userMapper.selectJoinPage(new Page<>(1, 10), UserDTO.class,
                new MPJQueryWrapper<UserDO>()
                        .selectAll(UserDO.class)
                        .select("addr.tel", "addr.address")
                        .select("a.province")
                        .leftJoin("user_address addr on t.id = addr.user_id")
                        .rightJoin("area a on addr.area_id = a.id"));
    }
}

对应sql

SELECT 
    t.id,
    t.name,
    t.sex,
    t.head_img,
    addr.tel,
    addr.address,
    a.province
FROM 
    user t
    LEFT JOIN user_address addr on t.id = addr.user_id
    RIGHT JOIN area a on addr.area_id = a.id 
LIMIT ?,?
还可以这么操作,但不建议
class test {
    @Resource
    private UserMapper userMapper;

    void testJoin() {
        List<UserDTO> list = userMapper.selectJoinList(UserDTO.class,
                new MPJQueryWrapper<UserDO>()
                        .selectAll(UserDO.class)
                        .select("addr.tel", "addr.address")
                        //行列转换
                        .select("CASE t.sex WHEN '男' THEN '1' ELSE '0' END AS sex")
                        //求和函数
                        .select("sum(a.province) AS province")
                        //自定义数据集
                        .leftJoin("(select * from user_address) addr on t.id = addr.user_id")
                        .rightJoin("area a on addr.area_id = a.id")
                        .like("addr.tel", "1")
                        .le("a.province", "1")
                        .orderByDesc("addr.id"));
    }
}

对应sql

SELECT 
    t.id,
    t.name,
    t.sex,
    t.head_img,
    addr.tel,
    addr.address,
    CASE t.sex WHEN '男' THEN '1' ELSE '0' END AS sex,
    sum(a.province) AS province
FROM 
    user t
    LEFT JOIN (select * from user_address) addr on t.id = addr.user_id
    RIGHT JOIN area a on addr.area_id = a.id
WHERE (
    addr.tel LIKE ?
    AND a.province <= ?)
ORDER BY
    addr.id DESC

针对以上 jar 感兴趣的，可以下载对应的源码，进一步的学习！

文章有帮助的话，在看，转发吧。
谢谢支持哟 (*^__^*）
MybatisPlus多表关联分页查询
Mr.xing的博客
09-04 5568
Mybatis-plus的多表关联查询的参数，可以使用LambdaQueryWrapper或QueryWrapper加入多个表查询条件，并使用Join方法进行关联。Mybatis-plus是一个Mybatis的增强工具，提供了许多功能强大的API，其中包括分页查询和多表关联查询。在Mybatis-plus中，连表查询可以使用LambdaQueryWrapper或QueryWrapper加入多个表进行查询，然后再使用IPage进行分页。
mybatis plus leftjoin 表如何去掉自动添加deleted=0条件
志存高远
05-28 2370
但请注意，这种方式并不能直接“去掉”已自动添加的条件，而是通过增加额外条件来达到目的，这在LEFT JOIN场景下可能不太适用或需要更复杂的处理。由于LEFT JOIN查询的特殊性，直接在Mybatis Plus的API层面优雅地去掉自动添加的逻辑删除条件较为困难，推荐使用直接编写SQL（方法2）的方式来精确控制查询条件，以满足特定的查询需求。：如果你不希望Mybatis Plus在任何查询中自动添加逻辑删除的过滤条件，可以在配置类中全局关闭逻辑删除功能。，这是为了在查询时自动过滤掉被逻辑删除的数据。
mybatis-plus-join:支持连表查询的mybatis-plus，mybatis-plus风格的连表操作提供wrapper.leftJoin（），wrapper.rightJoin（）等操作
03-15
mybatis加联接 支持连表查询的 使用方法 通用连表包装 安装 在项目中添加依赖 < dependency> < groupId>com.github.yulichang</ groupId> < artifactId>mybatis-plus-join</ artifactId> < version>1.1.1</ version> </ dependency> 或者克隆代码到本地，执行mvn install，再重新以上依赖 添加配置文件 @Configuration public class MybatisPlusConfig { /** * 启用连表拦截器 */ @Bean public MybatisPlusInterceptor paginationInterceptor () {
Mybatis-Plus-Join 表连接插件集成
最新发布
objectdsf的博客
09-05 873
Mybatis-Plus-Join是基于Mybatis-Plus的扩展插件，提供了便捷的表连接查询功能，支持左/右/内连接操作。安装需添加1.4.5版本依赖，并配置Mapper、Service继承JoinBaseMapper和JoinIService。使用时可创建JoinLambdaWrapper添加表连接（leftJoin/rightJoin/innerJoin），设置查询条件后必须调用end()结束连接。支持多表级联查询，通过selectAs映射字段到VO对象，保持与Mybatis-Plus一致的使用风
SpringBoot集成MyBatis-Plus-Join
道友，山高路远，如果找不到答案就去找自己。
04-11 2075
MyBatis-Plus-Join （简称 MPJ）是一个 MyBatis-Plus的增强工具，在 MyBatis-Plus 的基础上只做增强不做改变，为简化开发、提高效率而生。
mybatis plus join 连表查询 mybatis plus 连表神器
qq_31116181的博客
04-18 2562
mybatis-plus的多表插件完全按照mybats plus的用法来做，支持连表查询的mybatis-plus,mybatis-plus风格的连表操作提供 wrapper.leftJoin() wrapper.rightJoin()等操作, 支持一对一返回映射，多对多返回映射，自定义返回Vo，自定义表别名，自定义查询字段
MyBatisPlus mybatis-plus-join
hudeyong926的专栏
02-03 1万+
一、MyBatis Plus 介绍 MyBatis Plus是国内人员开发的 MyBatis 增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。 MyBatis Plus 的核心功能有：支持通用的 CRUD、代码生成器与条件构造器。 通用 CRUD：定义好 Mapper 接口后，只需要继承BaseMapper<T>接口即可获得通用的增删改查功能，无需编写任何接口方法与配置文件 条件构造器：通过EntityWrapper<T>（实体包装.....
Mybatis-plus做连接查询的插件:Mybatis-plus-join
qq_44140499的博客
05-08 3万+
Mybatis-plus做连接查询的插件:Mybatis-plus-join 文章仅用于记录自己在学习过程中遇到的问题与解决方法，希望对大家有帮助。 1、什么是Mybatis-plus-join？ Mybatis-plus-join是网上的大佬为解决Mybatis-plus做多表连接查询吃力而开发的一个工具，它能基于Mybatisplus进行功能升级，使其不再受限于单表查询，其中本人总结有以下几点： 对Mybatis-plus进行功能升级 ，提高开发效率； 使用方法与Mybatis-plus一样 ，学习
来了，MyBatisPlus的加入联表查询！
m0_71777195的博客
08-25 1400
众所周知，mybatis plus 封装的 mapper 不支持 join，如果需要支持就必须自己去实现。但是对于大部分的业务场景来说，都需要多表 join，要不然就没必要采用关系型数据库了。那么有没有一种不通过硬 SQL 的形式，通过框架提供 join 能力呢？答案是，可以有。经过一段时间的插眼排眼操作，成功的封装了一个 jar 包。本文讲讲它的用法。
来了，MyBatisPlus的join联表查询
uuqaz的博客
08-01 3531
众所周知，mybatisplus封装的mapper不支持join，如果需要支持就必须自己去实现。但是对于大部分的业务场景来说，都需要多表join，要不然就没必要采用关系型数据库了。那么有没有一种不通过硬SQL的形式，通过框架提供join能力呢？答案是，可以有。经过一段时间的插眼排眼操作，成功的封装了一个jar包。本文讲讲它的用法。...
SpringBoot+MybatisPlus实现联表分页查询
03-01
在本文中，我们将深入探讨如何使用SpringBoot集成MybatisPlus来实现高效的联表分页查询。SpringBoot以其简洁的配置和强大的依赖管理能力，成为现代Java Web开发的首选框架之一。而MybatisPlus则是在Mybatis基础上...
MyBatisPlus实现多表查询
小李同学的博客
05-28 1732
MyBatisPlus实现多表查询
MyBatis Plus 联合查询
阳宗德的博客
05-27 9444
MyBatis Plus 联合查询mybatis-plus-join使用方法安装使用核心类 MPJLambdaWrapper和MPJQueryWrapperMPJLambdaWrapper用法简单的三表查询分页查询MPJQueryWrapper简单的3表查询分页查询还可以这么操作,但不建议 mybatis-plus-join gitee 演示工程 一对一,一对多 使用方法 安装 Maven <dependency> <groupId>com.github.yulich
Mybatis-plus-join连表查询
weixin_39555954的博客
12-07 1万+
最近发现一个好玩的框架，我们知道mybatis-plus在连表查询上是不行的，如果需要连表查询，那么我们就得乖乖的去写xml文件了，但是今天发现一个新的框架 mybatis-plus-join。它既包含了mybatis-plus的所有优点，然后还支持连表查询，还支持对多，对一的查询，行了废话不多说直接看代码吧。
mybatis-plus-join mybatis-plus必备神器
热门推荐
博博的博客
07-20 4万+
mybatis-plus-join是mybatis plus的一个多表插件，上手简单，十分钟不到就能学会全部使用方式，只要会用mp就会用这个插件，仅仅依赖了lombok，而且是扩展mp的构造器并非更改原本的构造器，不会对原有项目产生一点点影响，相信大多数项目都有这俩插件，四舍五入就是没依赖。 ......
使用Mybatis-plus-join做多表查询
m0_59176231的博客
07-17 4928
mybatis plus join多表查询
mybatisplus-join与mybatis-plus
weixin_42759398的博客
06-01 3236
在 `select` 方法中，我们使用 `as` 关键字将订单表中的 id 和 amount 字段别名为 `orders.id` 和 `orders.amount`，以便能够将它们映射到 `UserVO` 类的 `orders` 列表中的 `id` 和 `amount` 字段。需要注意的是，如果你使用了实体类关联查询，那么在 `JoinWrapper` 中的实体类必须包含对应的关联属性，例如，在 `User` 类中必须包含一个名为 `orders` 的订单列表属性。
MyBatis-Plus联表查询(Mybatis-Plus-Join)
Lifelong learning
07-16 1万+
MyBatis-Plus联表查询(Mybatis-Plus-Join) xml
mybatis-plus-join
weixin_43887958的博客
06-17 2187
前言 在有主键的前提下: 1.含有其他索引字段: 用explain,会发现这三个执行流程一模一样,都用的是其他索引. 2.不含其他索引字段: 用explain,会发现count(*)和count(1)用的是主键索引,count(col)是没用索引的. 在没有主键的前提下: 1.含有其他索引字段: 用explain,会发现这三个执行流程一模一样,都用的是其他索引. 2.不含其他索引字段: 用explain,会发现count(*),count(1),count(col)这三个都是没用索引的. 先说结
mybatisplus怎么联表查询
08-13
<think>由于用户要求使用中文回答，并且需要在回答后提出3-5个相关问题，且以“§§相关问题§§”开头。 问题：mybatisplus怎么联表查询 回答： MyBatis-Plus（简称MP）本身并不直接支持联表查询，它主要专注于单表的CRUD操作。但是，我们可以通过以下方式实现联表查询： 1. **使用XML或注解编写SQL**：在Mapper接口中，可以使用MyBatis的注解（如@Select）或XML文件编写复杂的SQL语句（包括JOIN等）来实现联表查询。 2. **使用QueryWrapper自定义SQL**：通过QueryWrapper构造条件，然后结合自定义SQL来实现。例如，在Wrapper中设置条件，然后在Mapper中写一个包含JOIN的SQL，将Wrapper的条件动态拼接进去。 3. **使用第三方扩展**：如使用`mybatis-plus-join`（第三方扩展库）来支持类似MP风格的联表查询。 下面是一个使用自定义SQL（注解方式）的示例： 假设有两个表：`user` 和 `order`，一个用户有多个订单。 首先，在Mapper接口中定义方法： ```java @Select("SELECT u.*, o.order_number FROM user u LEFT JOIN order o ON u.id = o.user_id ${ew.customSqlSegment}") List<UserOrderVO> getUserOrderList(@Param(Constants.WRAPPER) Wrapper wrapper); ``` 然后，在Service中调用： ```java QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq("u.name", "张三"); List<UserOrderVO> list = userMapper.getUserOrderList(wrapper); ``` 另外，也可以使用XML文件编写SQL。 注意：MyBatis-Plus官方推荐单表操作，多表操作建议使用MyBatis原生的方式。 如果使用第三方库`mybatis-plus-join`，可以像下面这样： 首先，引入依赖（注意：这不是官方库，需自行确认版本和稳定性）： ```xml <dependency> <groupId>com.github.yulichang</groupId> <artifactId>mybatis-plus-join</artifactId> <version>最新版本</version> </dependency> ``` 然后，使用方式类似于： ```java List<UserOrderVO> list = userMapper.selectJoinList(UserOrderVO.class, new MPJLambdaWrapper<User>() .selectAll(User.class) .select(Order::getOrderNumber) .leftJoin(Order.class, Order::getUserId, User::getId) .eq(User::getName, "张三")); ``` 请根据实际需求选择合适的方式。 最后，按照要求提出相关问题： §§相关问题§§ 1. 在MyBatis-Plus中如何自定义SQL并实现动态条件查询？ 2. 使用第三方扩展库`mybatis-plus-join`进行联表查询时需要注意哪些问题？ 3. MyBatis-Plus的QueryWrapper能否直接用于多表查询？ 4. 除了联表查询，MyBatis-Plus还有哪些方式可以实现多表数据查询？ 5. 在MyBatis-Plus中，如何通过XML文件配置联表查询？</think>MyBatis-Plus 本身不直接支持联表查询，但可以通过以下方式实现： 1. **自定义SQL（推荐方式）** 在Mapper中编写自定义SQL语句，使用MyBatis原生语法实现JOIN： ```java @Select("SELECT u.*, d.dept_name " + "FROM user u " + "LEFT JOIN department d ON u.dept_id = d.id " + "${ew.customSqlSegment}") List<User> selectUserWithDept(@Param(Constants.WRAPPER) Wrapper wrapper); ``` 2. **使用`@TableField`关联查询** 通过字段映射实现伪联表（适用于简单关联）： ```java public class User { private Long deptId; @TableField(exist = false) private String deptName; // 关联字段 } ``` 3. **第三方扩展（mybatis-plus-join）** 使用扩展库实现链式联表查询： ```java List<UserDTO> list = userMapper.selectJoinList(UserDTO.class, new MPJLambdaWrapper<User>() .selectAll(User.class) .select(Department::getName) .leftJoin(Department.class, Department::getId, User::getDeptId)); ``` 4. **Service层拼接查询** 分步查询后手动组装数据（适合复杂场景）： ```java List<User> users = userService.list(); Map<Long, Department> deptMap = deptService.listByIds( users.stream().map(User::getDeptId).collect(Collectors.toList()) ).stream().collect(Collectors.toMap(Department::getId, d -> d)); ``` > **重要提示**：MyBatis-Plus官方推荐优先考虑单表操作+代码组装的方式，复杂联表建议使用原生MyBatis实现。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值