【Java后端】Spring Boot 集成 MyBatis-Plus 全攻略

Spring Boot 集成 MyBatis-Plus 全攻略

1. 为什么选择 MyBatis-Plus

  • 零侵入:在 MyBatis 基础上增强,不影响现有功能。
  • 内置 CRUD :无需写 XML/SQL,直接调用 BaseMapper 方法。
  • 强大插件:分页插件、性能分析、乐观锁、多租户等。
  • 更少样板代码:节省 70% 以上 Mapper 层代码量。

2. 依赖配置

pom.xml

xml 复制代码
<dependencies>
    <!-- Spring Boot Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- MyBatis-Plus -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.5.5</version>
    </dependency>

    <!-- MySQL 驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>

    <!-- Lombok -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

3. 基础配置

application.yml

yaml 复制代码
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/demo_db?useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: root123
    driver-class-name: com.mysql.cj.jdbc.Driver

mybatis-plus:
  mapper-locations: classpath*:mapper/*.xml
  configuration:
    map-underscore-to-camel-case: true

4. 实体类

java 复制代码
package com.example.demo.entity;

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

@Data
@TableName("user") // 映射数据库表
public class User {
    @TableId
    private Long id;
    private String username;
    private String email;
}

5. Mapper 接口

java 复制代码
package com.example.demo.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.demo.entity.User;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface UserMapper extends BaseMapper<User> {
}

✅ 继承 BaseMapper<User> 后,增删改查方法就全都有了。


6. Service 层

Service 接口

java 复制代码
package com.example.demo.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.example.demo.entity.User;

public interface UserService extends IService<User> {
}

Service 实现

java 复制代码
package com.example.demo.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import com.example.demo.service.UserService;
import org.springframework.stereotype.Service;

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

7. Controller

java 复制代码
package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {
    private final UserService userService;
    public UserController(UserService userService) {
        this.userService = userService;
    }

    // 查询所有
    @GetMapping
    public List<User> list() {
        return userService.list();
    }

    // 按ID查
    @GetMapping("/{id}")
    public User get(@PathVariable Long id) {
        return userService.getById(id);
    }

    // 新增
    @PostMapping
    public String add(@RequestBody User user) {
        userService.save(user);
        return "User added successfully!";
    }

    // 更新
    @PutMapping
    public String update(@RequestBody User user) {
        userService.updateById(user);
        return "User updated successfully!";
    }

    // 删除
    @DeleteMapping("/{id}")
    public String delete(@PathVariable Long id) {
        userService.removeById(id);
        return "User deleted successfully!";
    }
}

8. 分页插件配置

在 Spring Boot 启动类或配置类中加入:

java 复制代码
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MyBatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
        return interceptor;
    }
}

使用:

java 复制代码
Page<User> page = new Page<>(1, 5);
Page<User> userPage = userService.page(page);

9. 常用增强功能

  1. 条件构造器(代替手写 SQL):
java 复制代码
QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("username", "Tom");
List<User> users = userService.list(wrapper);
  1. Lambda 风格(类型安全):
java 复制代码
List<User> users = userService.lambdaQuery()
        .like(User::getUsername, "Tom")
        .orderByDesc(User::getId)
        .list();
  1. 批量操作
java 复制代码
userService.saveBatch(usersList);
  1. 乐观锁支持 :加上 @Version 注解 + 乐观锁插件。

10. 总结

  • 如果 SQL 比较简单,MyBatis-Plus 基本不需要写 Mapper XML。
  • 如果涉及复杂查询,可以 MP + 自定义 XML 混合使用。
  • 常见增强:分页、条件构造器、批量操作、乐观锁、多租户插件。

这样,就能快速从 MyBatis 手写 SQL 升级到 MyBatis-Plus 高效开发 🚀

相关推荐
聪明的笨猪猪7 分钟前
Java SE “面向对象”面试清单(含超通俗生活案例与深度理解)
java·经验分享·笔记·面试
聪明的笨猪猪13 分钟前
Java 集合 “List + Set”面试清单(含超通俗生活案例与深度理解)
java·经验分享·笔记·面试
Miraitowa_cheems1 小时前
LeetCode算法日记 - Day 59: 字母大小写全排列、优美的排列
java·数据结构·算法·leetcode·决策树·职场和发展·深度优先
似水流年,是谁苍白了等待2 小时前
Spring Boot + MyBatis plus + MySQL 实现位置直线距离实时计算
spring boot·mysql·mybatis
workflower2 小时前
将图片中的图形转换为可编辑的 PPT 图形
java·开发语言·tomcat·powerpoint·个人开发·结对编程
卡戎-caryon3 小时前
【Java SE】06. 数组
java·开发语言
想躺平的咸鱼干3 小时前
Spring AI Alibaba
java·人工智能·spring
老华带你飞3 小时前
学生信息管理系统|基于Springboot的学生信息管理系统设计与实现(源码+数据库+文档)
java·数据库·spring boot·后端·论文·毕设·学生信息管理系统
聪明的笨猪猪3 小时前
Java SE “泛型 + 注解 + 反射”面试清单(含超通俗生活案例与深度理解)
java·经验分享·笔记·面试
磨十三3 小时前
C++ 类型转换全面解析:从 C 风格到 C++ 风格
java·c语言·c++