【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 高效开发 🚀

相关推荐
m0_7482336413 分钟前
C++与Python:内存管理与指针的对比
java·c++·python
软件20531 分钟前
【JDK、JRE、JVM】
java·开发语言·jvm
m0_7482554141 分钟前
TailwindCSS vs UnoCSS 性能深度对决:究竟快多少?
java
薛家明43 分钟前
easy-query暴打efcore(包括其他所有orm),隐式Group看我如何在子查询做到极致的性能天花板
java·orm·efcore·easy-query·entityframeworkcore·dotnetcore
wudl55661 小时前
JDK 21 API增强详解
java·开发语言·windows
学习编程的Kitty1 小时前
JavaEE初阶——多线程(3)线程安全
java·开发语言·jvm
workflower3 小时前
微软PM的来历
java·开发语言·算法·microsoft·django·结对编程
江湖一码农3 小时前
[小白]spring boot接入emqx
java·数据库·spring boot
bbq粉刷匠5 小时前
从0开始学java--day6.5
java
lang201509286 小时前
Spring Boot构建RESTful服务与Actuator监控
spring boot·后端·restful