首页
/ 正文

springboot集成mybatisplus（超详细）

更新时间: 2025-03-21 21:03:55

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

前言

在现代Java Web开发中，SpringBoot集成MyBatisPlus已成为快速构建数据访问层的热门方案。SpringBoot凭借其开箱即用的特性简化了项目配置，而MyBatisPlus作为MyBatis的增强工具包，通过代码生成、条件构造器等特性显著提升了开发效率。本文将从基础环境搭建到核心功能实践，手把手引导开发者掌握这一组合的使用方法，适合编程初学者逐步理解，也能帮助中级开发者巩固进阶技巧。

一、环境准备与核心依赖配置

1.1 开发环境要求

Java 8+：推荐使用Java 17以兼容最新框架版本
SpringBoot 3.x：通过Spring Initializr快速创建项目骨架
MySQL 8.0+：数据库需配置好用户权限和字符集（如utf8mb4）

1.2 Maven依赖配置

在pom.xml中添加以下关键依赖，形成完整的开发环境：

<!-- SpringBoot Web基础依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- MyBatisPlus核心依赖 -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3</version>
</dependency>

<!-- MySQL驱动 -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.33</version>
</dependency>

<!-- Lombok简化代码（可选但推荐） -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.28</artifactId>
    <scope>provided</scope>
</dependency>

比喻说明：
这些依赖如同搭建乐高积木时的基础组件，每个依赖负责特定功能模块，共同组成完整的开发环境。

1.3 数据库连接配置

在application.yml中配置数据库信息，MyBatisPlus会自动读取这些参数：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

mybatis-plus:
  # 配置实体类包路径，自动生成别名
  type-aliases-package: com.example.entity
  # 配置mapper接口扫描路径
  mapper-locations: classpath*:mapper/*.xml

关键点说明：
type-aliases-package避免了传统MyBatis中手动配置每个实体类别名的繁琐操作，极大提升了开发效率。

二、快速入门案例：实现用户管理功能

2.1 实体类设计

使用Lombok的@Data简化getter/setter编写，@TableName明确数据库表名映射：

import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

@Data
@TableName("t_user")
public class User {
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

2.2 自动化Mapper接口

通过继承BaseMapper接口，获得CRUD基础能力：

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface UserMapper extends BaseMapper<User> {
    // 可在此扩展自定义SQL方法
}

2.3 Service层实现

在Service中注入UserMapper，实现业务逻辑分层：

import org.springframework.stereotype.Service;
import javax.annotation.Resource;

@Service
public class UserService {
    @Resource
    private UserMapper userMapper;

    public User getUserById(Long id) {
        return userMapper.selectById(id);
    }

    public void addUser(User user) {
        userMapper.insert(user);
    }
}

2.4 控制器暴露接口

通过RESTful API暴露数据操作接口：

import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/users")
public class UserController {
    @Resource
    private UserService userService;

    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.getUserById(id);
    }

    @PostMapping
    public void createUser(@RequestBody User user) {
        userService.addUser(user);
    }
}

完整流程演示：
通过curl -X POST -H "Content-Type: application/json" -d '{"name":"John", "age":25, "email":"john@example.com"}' http://localhost:8080/users即可完成用户创建。

三、核心功能详解与进阶技巧

3.1 条件构造器：灵活的查询语法

MyBatisPlus的QueryWrapper提供链式调用，替代传统XML的复杂配置：

// 查询年龄大于20且邮箱包含example的用户
QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.gt("age", 20).like("email", "example");
List<User> users = userMapper.selectList(wrapper);

比喻说明：
这如同拼装积木，每个条件（如gt()、like()）都是可自由组合的模块，最终形成完整的查询逻辑。

3.2 分页查询优化

通过Page对象实现分页，代码量仅为传统方式的1/3：

Page<User> page = new Page<>(1, 10); // 第1页，每页10条
Page<User> result = userMapper.selectPage(page, new QueryWrapper<User>().orderByAsc("age"));

3.3 自动填充字段

通过MetaObjectHandler实现创建时间、更新时间的自动维护：

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        this.setFieldValByName("createTime", LocalDateTime.now(), metaObject);
        this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);
    }
}

配置要点：
在实体类中需声明对应字段（如LocalDateTime createTime），并在application.yml中启用自动填充功能：
mybatis-plus: auto-fill-enable: true

3.4 事务管理简化

结合Spring的@Transactional注解，实现跨方法事务控制：

@Service
public class UserService {
    @Transactional(rollbackFor = Exception.class)
    public void addUserWithTransaction(User user) {
        userMapper.insert(user);
        // 其他数据库操作
    }
}

四、性能优化与最佳实践

4.1 逻辑删除机制

通过IS_DELETED字段实现软删除，避免直接删除数据：

// 实体类添加注解
@TableName(value = "t_user", logicDeleteValue = "1", 
            nonLogicDeleteValue = "0")
public class User {
    @TableLogic
    private Integer isDeleted;
}

4.2 SQL执行日志

在application.yml中开启SQL打印，方便调试：

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

4.3 动态数据源配置

对于多数据源场景，可通过AbstractRoutingDataSource实现动态切换：

@Configuration
public class DynamicDataSourceConfig {
    @Bean
    @ConfigurationProperties("spring.datasource")
    public DataSource druidDataSource() {
        return new DruidDataSource();
    }

    @Primary
    @Bean("dataSource")
    public AbstractRoutingDataSource routingDataSource(
            @Qualifier("dataSource") DataSource defaultDS) {
        // 实现动态数据源路由逻辑
        return new CustomRoutingDataSource(defaultDS);
    }
}

五、完整案例：用户管理模块实战

5.1 数据库表结构

CREATE TABLE `t_user` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `name` varchar(50) NOT NULL,
  `age` int DEFAULT NULL,
  `email` varchar(100) DEFAULT NULL,
  `create_time` datetime DEFAULT NULL,
  `update_time` datetime DEFAULT NULL,
  `is_deleted` tinyint DEFAULT '0',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

5.2 代码完整实现

通过上述章节的代码组合，可构建完整的用户管理模块，支持：

用户增删改查
分页查询与条件筛选
自动维护时间戳
逻辑删除功能

六、结论与展望

通过本文的讲解，开发者应能掌握SpringBoot集成MyBatisPlus的核心方法与进阶技巧。这一技术组合不仅简化了数据访问层的开发复杂度，还提供了丰富的扩展能力。对于希望进一步提升开发效率的开发者，建议：

研究IService接口的高级用法
探索代码生成器MapperGenerator的自动化能力
结合Swagger实现API文档自动生成

记住：技术的学习如同搭建积木，从基础模块开始逐步扩展，最终能构建出强大的应用系统。希望本文能为你的Java后端开发之路提供有力支持！

springboot集成mybatisplus（超详细）

前言

一、环境准备与核心依赖配置

1.1 开发环境要求

1.2 Maven依赖配置

1.3 数据库连接配置

二、快速入门案例：实现用户管理功能

2.1 实体类设计

2.2 自动化Mapper接口

2.3 Service层实现

2.4 控制器暴露接口

三、核心功能详解与进阶技巧

3.1 条件构造器：灵活的查询语法

3.2 分页查询优化

3.3 自动填充字段

3.4 事务管理简化

四、性能优化与最佳实践

4.1 逻辑删除机制

4.2 SQL执行日志

4.3 动态数据源配置

五、完整案例：用户管理模块实战

5.1 数据库表结构

5.2 代码完整实现

六、结论与展望

最新发布

Cursor @ 符号（千字长文）

POP3 协议（一文讲透）

IMAP 协议（保姆级教程）

RDP 协议（建议收藏）

SFTP 协议（保姆级教程）

UDP 协议（长文解析）

SSL 协议（手把手讲解）

TLS 协议（超详细）

ARP 协议（保姆级教程）

RARP 协议（建议收藏）