MyBatis-Plus实现多表联查方式(一对一,一对多使用)

更新时间：2025年10月15日 09:59:47 作者：慷慨

文章介绍了MyBatis-Plus-Join插件,一个在MyBatis-Plus基础上增强的工具,支持联表查询而不改变原有代码结构,MPJ插件无侵入性,兼容MyBatis-Plus的多种特性,并支持注解形式的一对一和一对多查询

1、前言

在使用mybatis-plus开发需求的时候会发现对于大部分的业务场景来说都会使用到join来进行联表查询，但是mybatis-plus封装的 mapper 不支持 join，如果需要支持就需要自己手动去实现，给大家推荐一个好用的插件（MyBatis-Plus-Join）。

2、介绍

Mybatis-Plus-Join（简称 MPJ）是一个 Mybatis-Plus的增强工具，在 MyBatis-Plus 的基础上只做增强不做改变，为简化开发、提高效率而生。

3、特性

无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑
无感引入, 支持MP风格的查询, 您会MP就会MPJ, 无需额外的学习成本
兼容MP的别名、逻辑删除、枚举列、TypeHandle列等特性
支持注解形式一对一、一对多和连表查询形式的一对一和一对多

4、使用

引依赖

需要 Mybatis-plus version >= 3.4.0

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

继承

（必须）mapper继承MPJBaseMapper

public interface CarIllegalMapper extends MPJBaseMapper<CarIllegal>
{
}

（可选）service继承MPJBaseService

public interface ICarIllegalService  extends MPJBaseService<CarIllegal>{}

（可选）serviceImpl继承MPJBaseServiceImpl

@Service
public class CarIllegalServiceImpl extends MPJBaseServiceImpl<CarIllegalMapper, CarIllegal> implements ICarIllegalService
{}

开始使用

现有一张car_illegal（车辆违章）表和一张attachments_file（附件）表，其关联关系是每辆违章车数据可能对应着一条或多条的违章图片（附件），以这两张表为例来进行一对一和一对多测试。

一对一

说明

CarIllegalDto.class 查询结果返回类(resultType)
selectAll() 查询指定实体类的全部字段
select() 查询指定的字段,支持可变参数,同一个select只能查询相同表的字段
selectAs() 字段别名查询,用于数据库字段与业务实体类属性名不一致时使用

leftJoin() 参数说明

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

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

selectAssociation()一对一查询
selectCollection()一对多查询

@SpringBootTest(classes = DeXinApplication.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@RunWith(SpringRunner.class)
@Slf4j
class DeXinApplicationTests {

    @Autowired
    private CarIllegalMapper carIllegalMapper;

    @Test
    public void testSelect() {
         MPJLambdaWrapper wrapper = new MPJLambdaWrapper<CarIllegalDto>()
                .selectAll(CarIllegalDto.class)
                .selectAssociation(AttachmentsFile.class,CarIllegalDto::getAttachmentsFile)
                   .leftJoin(AttachmentsFile.class,AttachmentsFile::getTargetId,CarIllegal::getId);
        List<CarIllegalDto> carIllegalDtoList = carIllegalMapper.selectJoinList(CarIllegalDto.class,wrapper);
    }
}

返回的实体类

@Data
public class  CarIllegalDto extends  CarIllegal
{
    AttachmentsFile attachmentsFile;

    List<AttachmentsFile> attachmentsFileList;
}

查询结果

一对多

  @Test
    public void testSelect() {
        MPJLambdaWrapper wrapper = new MPJLambdaWrapper<CarIllegalDto>()
                .selectAll(CarIllegalDto.class)
                .selectCollection(AttachmentsFile.class,CarIllegalDto::getAttachmentsFileList)
                .leftJoin(AttachmentsFile.class,AttachmentsFile::getTargetId,CarIllegal::getId);
        List<CarIllegalDto> carIllegalDtoList = carIllegalMapper.selectJoinList(CarIllegalDto.class,wrapper);
        System.out.println(1);
    }

结果

分页查询

连表分页查询返回所有命中记录(请启用mybatis-plus分页插件）

import com.baomidou.mybatisplus.core.metadata.IPage; 


   @Test
    public void testSelect() throws IOException {
        MPJLambdaWrapper wrapper = new MPJLambdaWrapper<CarIllegalDto>()
                .selectAll(CarIllegalDto.class)
                .selectAs(AttachmentsFile::getId,CarIllegalDto::getCarNo)
                .selectCollection(AttachmentsFile.class,CarIllegalDto::getAttachmentsFileList)
                .leftJoin(AttachmentsFile.class,AttachmentsFile::getTargetId, CarIllegal::getId);
        IPage<CarIllegalDto> carIllegalDtoList = carIllegalMapper.selectJoinPage(new Page<>(1, 10),CarIllegalDto.class,wrapper);
        System.out.println(carIllegalDtoList);
    }

结果

5、MPJLambdaWrapper所有方法说明

select

查询指定字段

select(AttachmentsFile::getName)

支持可变参数

select(AttachmentsFile::getName,AttachmentsFile::getEnterpriseId)

自定义字符串查询,需要对查询的表命名别名

select("file.id");
select("file.id as 'pid'");
select("file.id", "file.name");

//需要对表进行别名
 .leftJoin(AttachmentsFile.class,"file",AttachmentsFile::getTargetId,CarIllegal::getId);

selectAll

查询指定类的全部字段

.selectAll(CarIllegalDto.class)

注意事项：

一般一次查询只建议调用一次selectAll(), 因为不同表之间可能会存在相同的字段, 比如id,create_time等通用字段, 多次调用会导致字段名重复, 除非能保证字段不重复
所以一次查询推荐只使用一次, 并且通常是对主表使用, 其他表字段通过其他方式查询, 比如select, selectAs, selectAsClass等

selectAs

别名查询

.selectAs(AttachmentsFile::getId,CarIllegalDto::getCarNo)

//对应sql
t.id AS carNo

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

详解Java线程池和Executor原理的分析
这篇文章主要介绍了详解Java线程池和Executor原理的分析的相关资料,这里提供实例及分析原理帮助大家理解这部分知识，需要的朋友可以参考下
2017-07-07
Java IO API实现获取路径信息并去除冗余信息
这篇文章主要为大家详细介绍了Java IO API实现获取路径信息并去除冗余信息,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
2026-03-03
J2SE基础之JDK环境变量配置
进行java开发，首先要安装jdk，安装了jdk后还要进行环境变量配置,下面我们就来详细探讨下这个问题。
2016-05-05
java使用正则抓取网页邮箱
这篇文章主要为大家详细介绍了java使用正则抓取网页邮箱的相关资料，感兴趣的小伙伴们可以参考一下
2016-05-05
java实现人员信息管理系统
这篇文章主要为大家详细介绍了java实现人员信息管理系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-02-02
使用Java实现在Excel中创建下拉列表
下拉列表（下拉框）可以确保用户仅从预先给定的选项中进行选择,这样不仅能减少数据输入错误,还能节省时间提高效率,下面我们就来看看如何在java中利用免费库实现创建下拉列表吧
2024-03-03
java时区时间转为UTC的代码示例和详细解释
作为一名经验丰富的开发者,我经常被问到如何将Java中的时间转换为UTC时间,这篇文章主要介绍了java时区时间转为UTC的代码示例和详细解释,文中通过代码介绍的非常详细,需要的朋友可以参考下
2025-09-09
Java三大最常用集合List、Set、Map用法详解
在Java集合框架中,List、Set、Map是最核心的三大接口,它们分别对应线性表、集合、键值对映射三种数据结构,各自有独特的设计目标和适用场景,这篇文章主要介绍了Java三大最常用集合List、Set、Map用法的相关资料,需要的朋友可以参考下
2026-02-02
spring aop底层原理及如何实现
这篇文章主要介绍了spring aop底层原理及如何实现，帮助大家更好的理解和学习使用spring aop，感兴趣的朋友可以了解下
2021-04-04
java web SpringMVC后端传json数据到前端页面实例代码
本篇文章主要介绍了java web SpringMVC后端传json数据到前端页面实例代码，具有一定的参考价值，感兴趣的小伙伴们可以参考一下。
2017-03-03